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This kook is for those who need to know 
what iS involved in prcgramming the IBM 
3270 Information Display Systen. 


This kook is for those programmers who plan 
and code the panels seen on 3270 displays. 
It should be used in ccnjunction with the 
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For those programmers who write the access 
method macro instructicns or other I/0 
instructions, this manual is to ke used in 
conjunction with the aprropriate access 
method or IBM Program Froduct puklications. 


jow This Pook Is Organized 


This manual is divided into six chapters: 


Chapter 1, The 3270 Data Stream and 
Extensions to It, intrcduces and 
explains the 3270 data stream. It 
shows examples of the 3270 data stream 
and the 3270 extended data stream. It 
discusses the enhancements to the data 
stream, such as Cclor, Extended 
Highlighting, and Programmed Symbol 
sets. 


Chapter 2, Screen Lesign, introduces 
important 3270 ccncepts. It shows an 
example of what a 3270 display message 
might look like, what ccding elements 
are required to write this message in 
your program, and how terminal 
operator input might ke handled. 


Chapter 3, Screen Management, suggests 
macro definiticns and ,rogramming 
routines that might ke written to 
encode and decode messages to and from 
the display. 


Chapter 4, BTAM Suffort, suggests 
including IyvO operations (reading, 
writing, error recovery) in a module 
separate from message formatting. It 
contains descriptions and flowcharts 
to aid in writing error recovery 
routines for use with ETAM. It 
discusses sense/status analysis. 


Chapter 5, TCAM Support, suggests 
handling messages by means of two 
modules for the user's application 


program. It describes the TCAM macro 
instructions that affect the 3270. It 
Suggests how to handle remote 
printers. 


Charter 6, VIAM Support, summarizes 
the VTAM information for the 3270. It 
describes using VTAM with SNA and 
non-SNA 3270s. It suggests guidelines 
for making ncen-SNA and SNA 3270s 
compatible in the same network. 
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To understand how the terminal operator 
sees the 3270: 


Crerator's Guide for IBM 3270 


Information Display System, GA27-2742 


TEM 3270 Information Display System 


GA27-2750 
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As a reference on how the 3270 (including 
the printers) works: 


Color and Programmed Symbols, 


GA33-3056 
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GX20-1878 
Panel layout sheets: IBM :270 
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If you are using BTA: 
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Fogramming suEPLEment Lor tae 
{ Information [Tisplay Systen, 
GC27-6977 (applicakle tc DOS Release 
26 only) 


DOS Version 4 BIAr, GCz27/-6978 


IBM System/360 Oryera asic 
Telecommunications Access Method, 
GC3C0-2C04 


DOS/VS BIAM, GC27-6989 


CS/VS BLAM, GC27-6€980 


If you are using TCAM: 
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OS TCAM User's Guide, 6C30-2025 


GC30-2034 


If you are using VIAM, cr ACE/VTAM: 


iv 


ting System Basic 


ACF/VIAM System Programmer's Guide 
(refer to Concepts and Planning for 
the appropriate form number) 


ACF/VTAM Macro Language Reference, 
SC38-026 


Macro Language Guide, 


ACF/VIAM Programming, SC27-0449 


Installation (LOS/VSE), 


Installation (OS/VS), 


Advanced Communications Function for 
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SUMMARY OF AMENDMENTS (February 28, 1980) 
TC GC27-6999-2 BY REVISION GC27-6999-3 


This edition provides new programming 
information for the following 3270 
components: 

e 3274 Control Unit 

a 3276 Control Unit LTisplay Station 


e 3278 Display Staticn 


e 3279 Colcr Diszlay Station 

e 3287 Printer 

e 3289 Line Printer 

This editicn covers the enhancements made 
to the 3270 data stream for Color, Extended 
Highlighting, and Programmed Symbols. It 


also corrects several technical 
inaccuracies. 
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INTRODUCTION 


This chapter introduces the 3270 data stream and the extensions that 
have keen made to this data stream. These extensions, which include 
Color, Extended Highlighting (reverse video, blink, and underscore), and 
Programmed Symbols (user-defined symbol sets), enhance the fresentation 
of data at the 3270 device. Chapters 2 and 3 explain how to lay out and 
code a panel for display. 


For you to use whatever you have created for display and/or printing, 
ycur information must ke communicated to a 3270 device or control unit. 
This information is ccmmunicated to the 3270 device by use of the 3270 
data stream, which is made up of structured fields, or commands, control 
Characters, orders, attributes, and/or data. 


Structured fields provide another format for sending information to a 
display or printer by use of the extended 3270 data stream. (Structured 
fields are discussed later in this chapter.) 


Commands control such things as whether you write to or read from a 
display and whether the screen is erased before new data iS written. 


Control characters are used with certain commands to perform such 
functions as sounding the audible alarm, formatting the printer, and 
restoring or enabling the keyboard. 


Crders are instructions written to the 3270 to tell the display unit how 
to format your panel. 


Attributes determine the characteristics of the fields andycr characters 
within a field. 


Data is the information ycu are displaying or printing. 
THE 3270 DATA STREAM 


The 3270 data stream is a formatted data stream consisting of a command 
and, for write type ccmmands, of a write control character (WCC) 
followed by orders, attributes, and/or character data. The 3270 command 
byte defines the function tc ke performed on the character Luffer. 
Functions that may ke specified include: 


® WRITE to the character kLuffer 
e ERASE and then WRITE to the character buffer 


e ERASE WRITE/ALTERNATE to the character kuffer and change the effect 
cof the buffer size 


é READ the full character tuffer 


@ READ only the modified data from the character buffer 
@ ERASE ALL the unprctected data from the character buffer 


The 3270 data stream is based upon the presence of a mapped character 
kuffer in the device. There is a fixed one-to-one relaticnship between 
each character storage location in the buffer and each character 
position on the display. fFcr instance, ccnsider a display (Figure 1-1) 
for which the display screen is composed of 12 rows of 80 columns each. 
Row 1 maps to the first 80 character storage fositions in the character 
tuffer, row 2 maps to the second 80 character storage positicns, and so 
on. This sequence is the same whether the display size is 12 rows of 80 
columns or up to 27 rows of 132 columns. When the ERASE/WRITE ccmmand 
is transmitted to the device, the character buffer is first cleared to 
nulls (X'00"') and subseguent text is written into the character Luffer 
sequentially. 


The character buffer may contain codes for graphic characters or field 
attribute bytes, as shcwn in Figure 1-2. Since each stcrage location in 
the character buffer is mapped to a screen position on the display, 
field attribute bytes take ug a character fosition on the display. The 
3270 field attribute defines a field as the suksequent field attribute 
byte position plus the character positions uf to, but not including, the 
next field attribute Lyte in the character Luffer. 


In the 3270 data stream, the field attribute appears as a valid graphic 
Character (between X'4C' and X'FE') in the data stream. In the 3270 
data stream, following a write type command, there is a Write Control 
Character (WCC). ‘the &CC, like the field attribute, may also be a valid 
graphic character. The ceding and functicns are defined in Figure 2-26 
(Chapter 2). The data to ke written to the character Luffer follows the 
WCC. The character data may be intermixed with the control codes cr 
crders to provide formatting functions in the character Luffer. Fora 
description and definition cf the commands and orders, refer to the IB 
3270 Information Display System: Component Description, GA27-2749. 
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HCW FIELDS ARE DEFINEL 


With this introduction to the 3270 data stream, consider the example 
Shown in Figure 1-3. In this example, first, the character buffer is 
erased by the ERASE/WRITE command; then, the WCC is precessed; finally, 
the orders, attributes, and data are interpreted in sequential order. 


The first order in the data stream is generally a Set Buffer Address 
(SEA) order. This order includes two address bytes and determines the 
EFosition in the character Luffer where the data or attribute Lytes will 
ke stored. The address bytes are generally followed by a Start Field 
(SF) order and a field attriktute. The field attrikute is stored at the 
cufrer location specified in the SBA order. 


Each data field is estaklished by writing a field attrikute as the first 
fFosition of the field. The placement of attribute bytes defines the 
field lengths, and the content of the attrikute byte defines the other 
field characteristics. All the characters in a field, except the 
attribute byte itself, assume identical characteristics Lased on the 
specifications within the attribute byte. 


Field attributes can te modified or removed Ly a 3270 program, and 
changing the content cf. the field attribute alters the characteristics 
cf the field. 
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Display Character Buffer 


Figure 1-1. 3270 Mapped Buffer 


Attr 0 


<> Asc 


Display Character Buffer 


Figure 1-2. Mapping of Attribute and Graphic Characters to the Display Screen 


NAME: <> 
<> STREET ADDRESS: <> 
i<> city:<> 


|< STATE: ZIP: <> 


Data Stream 


Figure 1-3. A Sample 3270 Data Stream 


Following the field attribute, the character string "NAME" is stored in 
sequential character locations in the buffer. The next SBA order sets 
the current buffer address tc a new locaticn, and the process continues 
until the entire data stream has been interpreted. 


FASE COLOR 


To facilitate entry into the use of color, kLase color produces color 
displays from existing 3270 application programs with little or no 
repregramming. Fields can ke displayed in red, klue, green, or white. 
Field color is determined by the four combinations of the field 
protection and intensity attributes. 


Fase color allows all frograms that have been written for 3270 display 
stations and printers to execute in color on the equivalent 3279 cr 3287 
Model 1C or 2C, provided these programs use the field attributes of 
protection and intensity. Color will ke produced as follows: 


Resulting Color 3279 


Resulting Color Switch in Switch in 
Protection Intensity 3287 1€ and 2€ Color Mode Mcnochrome Mode 
Frotected Intensified Black or greent White White 
Unprotected Intensified Red Red White 
Protected Normal Flue Blue Green 
Unprotected Normal Green or black! Green Green 


1Pepending on the Ease Color Specify feature ordered with the printer 


keen defined), the 3279 will display all characters in green; the 3287 
Mcdels 1C and 2C will print in black. 


In Base Color mode, the protected and unprotected field attributes still 
determine whether the input data format is fixed or variakle; cclor is 
only a secondary effect of the attribute characteristics. Consequently, 
programming in these cclors may ke restricted ky the way in which the 
logic of an applicaticn program needs to use the protection and 
intensify attributes. 


Eecause the field attributes govern base cclor, the colors apply only to 
whole fields. It is not possible with this system to give different 
colors to separate characters within a field or to use colcr in 
unformatted layouts. 


EXTENSIONS TO THE 3270 DATA STREAM 
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Extensions to the 3270 data stream have been made to enhance the 
presentation of data at the device. These enhancements provide the 
capability for expressing the Extended Color, Programmed SymkEol set, 
and/or Extended Highlighting of the data to be displayed or printed at 
any terminal capable of interpreting these extensions to the 3270 data 
stream. To accomplish this, three new orders and one command have been 
defined to provide new functions in a device-independent manner, and the 
attribute concept has Leen expanded. 


ATTRIBUTES 


Remember that the 3270 field attribute is encoded to appear as a graphic 
character in the data stream and takes up a character fosition in the 
character buffer and cn the screen. For the extended 3270 data strean 
functions, the concept of an attribute is different. The attrikute has 
to be general in that it can apply to a character as well as to a field. 


The attribute structure used in the extended 3270 data stream defines 
all attributes as an attribute type followed by an attribute value, in 
much the same way that an attribute is expressed in the English 
language; for example, "The COLOR of this car is BLUE." Each attribute 
type has an assigned 1-kyte code. Most attrikute types may ke applied 
equally well to a character cr to a field. For the extended 3270 data 
stream, each attribute type has associated with it a set of valid 
attribute values: | 


Attribute Type Attribute Value 


Color Red, blue, yellow, turquoise, green, 
Fink, white 


Extended Highlighting Blink, reverse video, and underscore 


Programmed Symbol set Nonloadable character set or Loadable 
Programmed Symkol set (see Programmed 
Symboi sets) 


3270 Field Attributes 

There are three kasic fcrms cf attributes for extended attriktute 
terminals. The first was defined under the heading "3270 Lata Stream" 
for normal 3270 field definition. This attrikute defines the Leginning 
of a field as descriked in tke 3270 data stream and associates the 
following attributes with the field: 


@ Protectedyvunprotected fields 


® Alphamericynumeric fields 


@ Cisplay/nondisplay fields 


e Intensity of fields (When high intensity is used on 3279 Color 
Lisplays, the character cr field is displayed in white.) : 


e Selector-pen-detectable fields 
e Tab stop positions (unprotected fields) 


(See Figure 2-23 fcr hexadecimal values.) Each of these field 
attributes occupies a character position in the character buffer, 
and, during a display or printout, its character location appears as 
a space. 


Fxtended Field Attrikutes 


a cep aep aur em ce om eo aE «a =~ a UD ab aS SP a aE ao cee 


The second form of attribute is the extended field attribute. This 
attribute provides additional field attribute definition beyond that 
Frovided by the 3270 field attribute. It defines field characteristics 
such as field color, field highlighting (blink, reverse video, or 
underscore), and Programmed Symbol set of the field. 


Extended field attributes are always associated with a field attribute. 
An extended field attribute does not occupy a position in the character 
buffer and does not display cr print. 


Character Attributes: The third form of attribute for extended attrikute 
terminals provides definiticn of character attrikutes. These attributes 
are associated with individual characters to define characteristics such 
as Programmed Symbol set, character color, and character highlighting. 


The field attributes of any single character are superseded by the 
Character attributes associated with it. A character attrikute does not 
occupy a position in the character buffer and does not display or print. 


Start Field Extended (SFE) Order (X'29") : The first of the new data 
stream orders defined to deal with the extended field and character 
attributes, as well as the 3270 field attributes, is the Start Field 


Extended (SFE) order. Its syntax is: 


ERE: hae ee ee re ee aly Cie ae ee ee aes Gani oe aaa eRe ees enna ae eae ak aed Cale eka ae iat peamaeao aires | 
ISFE [n]First attribute|First attribute| ..... [nth attribute|nth attribute] 
“~x'29g"y | type | value , | | type | value ] 
Oa a a A ie eee ald as nme an ee emia s 


In the data stream, the byte count following the SFE order code 
indicates the number of "attribute type and attribute value" pairs that 
follow; the specified number follows the count. The use of this order 
is illustrated in Figure 1-4. Note that only the required attributes 
need to be specified. The unspecified attributes in the current kLuffer 
are set to nulls, and the current buffer address is incremented by 1. 

In this example all the unprotected fields are defined as underscored. 
Thus, the fields that the operator can enter will stand out from the 
rest of the fields on the panel. If an invalid attrikute type or value 
is specified, processing of the outbound data stream stcps, and an error 
code is returned. 


<> NAME: <> 


<> STREET ADDRESS: <> 
<S city: 
<> STATE: &> <> ZIP: 


Figure 1-4. Using the Start Field Extended Order 


crder, is identical with the Start Field Extended order: 


First First nth 
Attribute Attribute Attribute 
Type Value Value 


The Modify Field order allows specified field and extended field 
attrikutes to be modified without having to respecify all the attributes 
of the field. See Figure 1-5, where the application program wishes to 
highlight the zipcode field ky changing its highlight attribute to 
reverse video. This is done with the Modify Field order without having 
to respecify the entire string of attributes previously associated with 
the field. The values of the attribute types that are selected in the 
order are changed to the new values specified, and the current buffer 
address is incremented by 1. The values of the attribute types not 
selected in the order remain unchanged. 


<> NAME: <> John Smith. 


<> STREET ADDRESS: <> —_123 South Main Street 


=S CITY:<—> Kingston <> 
<> STATE: NY. zip: (2499 =< 


= we 


Field Attribute Location 


Note: ae | indicates reverse video. 


Figure 1-5. Using the Modify Field Order 


If the current buffer address is not a field attribute when a Modify 
Field order is processed, an error occurs and an error code is 
returned. If an invalid attribute type or value is specified, 
Frocessing of the outkound data stream stops, and an error code is 
returned. 


Set Attribute (SA) Order (X'28'): The Set Attribute order provides the 
akility to associate attributes with individual characters or strings of 
characters rather than with fields. The syntax of the Set Attribute 


crder is: 


Boe a Gea ee pee phan Fg ie ey ee ge a 
{SA jAttribute type|Attrikute Value| 
[x*28"| i ! 
a aid 


For this order, only a single attribute "type and value" pair follows 
the order. 


Every data character that fcllows a Set Attribute order in the outbound 
data stream is stored in the buffer with an associated character 
attribute having the tyre and value specified in the order. The 
specified attribute is associated with all subsequent data characters in 
the outbund data stream (even when they are directed to ncnsequential 
addresses) until either (1) another write-type command is transmitted, 
(2) a new Set Attribute order changes the attribute, (3) the Clear key 


is depressed, or (4) the device is powered off. 


The character attribute value determines how each associated data 
Character is displayed (for example, in reverse video). If a character 
attribute value is xX'00', then the highlighting attributes applied to 
the associated character are specified by the extended field attrikute. 


If an invalid attribute type or value is specified, processing of the 
cutbound data stream stops, and an error ccde is returned. 


In the example in Figure 1-6, the initial SA order indicates that all 
the characters following in the data stream are to be displayed with the 
reverse video attribute. Thus, the input data, John Smith, etc., which 
follows in the data stream will be displayed in reverse video characters 
independently of the highlight specified in the extended field attrikute 
of the fields in which the characters are stored. 


<> Name: <> Gennsmim] ls 
<> STREET ADDRESS: <> [123 South Main Steet] > 


\ CITY: S [Kingston] <> 
<> STATE: > [NY] <> ZIP: <> [12401] 


Figure 1-6. Using the Set Attribute Order 
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The model for attribute processing is shown in Figure 1-7. For each 
character position in the character buffer, there is an associated 
Eosition in the Extended Attribute Buffer (EAE). Where the character in 
the character buffer is a field attribute, the associated fosition in 
the EAB is interpreted ky the hardware as an extended field attrikute. 
Where it is a graphic character, the associated position in the EAB is 
interpreted as a character attrikute. The extended attrikutes do not 
occupy a position in the character buffer, but instead are in a related 
Fosition in an EAE (Figure 1-7). 


Now, if we were to use an extended field attribute, such as underscore, 
then the relation between character and extended field attrikutes would 
be that shown in Figure 1-8. Remember that the position in the EAR 
associated with a field attribute character is interpreted as an 
extended field attribute, and those positicns associated with the 
graphic characters are interpreted as character attrikutes. 


When the character attributes associated with characters ina field are 
not explicitly defined (NULL), the characters are displayed with the 
attributes specified fcr the field. As seen in Figure 1-9, when the 
character attributes are non-null, the characters are displayed with the 
attributes specified fcr the character, overriding the field attribute 
specification. 


defined for the Set Attribute, Start Field Extended, and Mcdify Field 
crders. All other attribute types and values are rejected. 


Type Code Type 
X'QOO! Character Attribute Reset (used only with SA order) 
X*'4t! Extended Highlighting 
xXty2e Colcr 
X'43t Programmed Symbols (PS) 
X'CO! 3270 Field Attribute (not used with SA order) 
0 ~ =a 
; >, Attribute 
. 
2 8 | ~ Character 
3 lc | ~ Attributes 
® s.™ 
® @ ® ® 
Display e e 4 : 
ie a 
Character 
Buffer Extended 


Attribute 
Buffer 


Figure 1-7. Model for Character and Extended Field Attributes 
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Figure 1-8. Relationship of Character and Extended Field Attributes 


Extended 
Field 
Attribute 


Character 
Attributes 


Character \ 
Buffer 


Figure 1-9. Character Attribute Override 
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in the 3270 data stream. Any character defined with a character 
attribute value of X'C0Q' will assume the characteristics defined Ly the 
extended field attrikute. 


e Character attributes 
X'00" - (Sets all character attributes specifiable in the. 
SA order to their default value if type equals 
X'00'. This attribute type/value pair (X'00' 
X¥'00') ccde may only appear in the SA order.) 
e Color | 


X'00' - the color will te green on a 3279 and black on a 3287. 
X'F1" - Blue 


10- 


X'F2' — Red 

X'F3" - Pink 

X'F4" - Green 

X'F5" - Turqucise 

X'F6" - Yellow 

X'F7' - White for 3279, black for 3287 


e Extended Highlighting 


X'O0" - It will assume the characteristics of the defined field 
attribute. 

X'*F1! -— Blink 

X'F2" - Reverse Video 

X'F4*" — Underscore 


e Frogrammed Symbol set 


X'00' - The nonlcadable character set shipped with the device 
is used. 
X"4O'-X*EF" - Coded Graphic Character Set Local ID (CGLI) for loadable 
Programmed Symrol sets 
X'*F1" - APL/Text character set (nonlcoadable symbol set, only for 
SA order) 


STRUCTURED FIFLDS 


As pointed out earlier, the 3270 data stream is a formatted data strean. 
To provide additional contrcls and transmit various data types other | 
than character, it was necessary to define a new data structure in the 
data stream. This is termed "structured fields." 


In the 3270 data stream, structured fields are introduced with a new 
ccmmand, the Write Structured Field (WSF) command. This new command 
dces not contain explicit control information as the other 3270 commands 
do. It Simply means, "Here is data ina aL Cee eESe field format." 


Fcllowing the WSF command, all data in the transmission must be in 
structured field format. A structured field transmissicn has the form 
shown in Figure 1-10. 


The structured field syntax permits variable-length data and contrels to 
be encoded in such a way that a device that is processing the data 
stream sequentially can deccmpose a sequence of fields inte its 
ccmponent fields without having to scan every byte. Each structured | eae 
field contains a 2-byte-length field. This indicates the length ‘of: the 
field (including the length ktytes), in effect, pointing to the: next. 


structured field in the transmission. Next follews a i-byte type ‘fielay 


and then parameters and/or data in the format defined Ey the type code, — 
If the value specified in the length field is zero, this structured 
field is treated as the last structured field in the transmission. The 
type field in the structured field identifies the purpose cf the field. 


| Write Structured Structured Field Structured Field Structured Field 
: e@e0@ 
. Field Command 1 2 n | 


-” ~ 
Parameters and/or Data 


Figure 1-10. Structured Fields 


The types of structured fields are as follows: 


Structured Field | Type Code 


Outbound Function 


Load Programmed Symbols (Load PSs) x'06! 
Read Partition Query Xx'o1' 
set Reply Mode x'09g? 


Inbound Function 


Query Reply X'81"' 
Under Query Reply, the 6 Uiewiag 
structured fields are used: 


Usable Area X'8i' 
Symbol Sets x*65'* 
Color 7 X'86! 
Highlighting X"87' 
Reply Mode xX'88! 


The structured field, Load Frogrammed Symbols, is used to lcad the 
Frogrammed Symbol sets into the buffers. This command and guery will be 
discussed here. For a description of the other types of structured 
aes refer to sete TEX 3270 Information [isplay System: Component 


load Programmed Symbol Set (Load PS) X'06': The Load Programmed Symbol 
set is one type of structured field defined as an outkcund control 
function. It is used to load character definition data into the device. 
A loadable character set contains 190 contiguous addressable character 
Slots, which are associated with data stream code points X'41' through 
X'FE'. The slot associated with X'40" can ke addressed, Lut cannot ke 
loaded and contains a space. This structured field causes characters 
andyor symbols to ke lcaded into contiguous addressakle slots. If no 
data is transmitted with this structured field, the operation is 
executed as specified in the parameters (see Figure 1-11) and no data is 
loaded. This means that characteristics of the symbol set may he 
changed without altering the contents of the symbol set. 


As an example of structured fiela usage, ccnsider the loading of 
Programmed Symbol (FS) sets. The PS attribute operates as shown in 
Figure 1-12. The display lcoks at the PS attribute for each character 
as it prepares to display it. If the character set specified for the 
character is the ncnloadable character set (PSO), the dot pattern for 
the character is extracted from a nonloadable character set installed in 
the device. If the character set specified is a loadable Frogrammed 
Symbol set, the display extracts the dot patterns for the character or 
symbol from a user-defined symbol set (PSF here). The Programmed Symbol 
set is specified by the PS attrikute. The EBCIIC character code defines 
which character in the PS is to be displayed. To follow the example 
further, the format for the WSF to load a FS set is given in Figure 
1-11. This command is then used to create the box "A" in ESF in Figure 
1-12. 
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Length Length of structured field. 


Basic/Extended Basic or extended form. 


Basic form. 
Extended form. 


-- Clear PS storage 


Do not clear PS storage. 
Clear the PS (plane) specified before loading the 
character data in this structured field. 

Skip suppress. 


b‘0’ Suppression off. 


b‘1’ Suppression on. 
3 
4-7 Display unique type: 


(Type 1) 18-byte form: the first 2 bytes contain 
a 16-bit vertical slice; the following 16 


bytes contain 8-bit horizontal slices. 


(Type 2) Type 1 compressed. 


Printer unique type: 


(Type 5) 
(Type 6) 


(alias) 


Column loading (from left to right). 
Type 5 compressed. 
Coded Graphic Character Set Local ID: 
X'40' through X‘EF’ 

X'FF’ indicates that the storage 


associated with this CGLI is free. 
Beginning EBCDIC Code Point (X‘41' through 
X'FE‘) inclusive 


PS set storage number (X‘0O2 through X‘07’) 


| | 
Posed 


Storage 


Figure 1-11 (Part 1 of 2). Format of the WSF for Load PS 


Bytes 7 va 12 are parameters for the sxteatied form. 


Length of parameters for the extended 


form. This includes the length parameter 
itself. The parameters defined below may 
be progressively included by specifying the 
appropriate length. Omitted parameters are 
equated to X‘00' per missing byte. Action 
is the same as receiving a byte containing 
x‘00'. 

| All points available. 
All points available. 


| Not all points available. 


CGLI compare 
No CGLI compare 


PS set is keyboard-selectable. 


PS set is not keyboard-selectable. 


X00" 


Number of X-units in block matrix. 


i ane Number of Y-units in block matrix, 


Onepyte codes. 


Color planes. 


b’000’ 
b‘001’ 
b’010’ 
b‘100° 


Single or all planes 
Blue 
Red 


Green 


Figure 1-11 (Part 2 of 2). Format of the WSF for Load PS 


The description 
Bytes 0 and 1 
Fyte 2 


Byte 3 
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of the Lyte function of Figure 1-11 is as follows: 


Give the length of the structured field. 


Gives the function to be perfcrmed. 
Bit C indicates whether byte 7 is included. 


Bit 1.- When bit 1 is set to 1, the entire PS storage 
selected for loading is cleared of any previous | 
character data. This can ke done by overwriting with 
character data or nulls. If the bit is set to 0, the 
selected PS storage is not cleared; thus, characters can 
be added to an existing character set. For a 
triple-flane set, only the plane(s) indicated in Lyte 12 
is cleared. 


Non-loadable 
Character 
Set Storage (PSO) 


Figure 1-12. 
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Byte 4 


Eyte 5 


Byte 6 


Eyte 7 


Byte 8 


Fyte 9 


Byte 10 


16 


Bit 2 controls the vertical positioning of a row of 
characters. The next row is fositioned vertically 
adjacent to the current row if the current row contains 
a character from the PS set having SKIF SUFPRESS on. If 
SKIP SUFPRESS is off, the row positioning is unaffected 
by the occurrence of a character from this FS storage. 


Bits 3-7 specify the type of PS format. fFcecr type 1 or 
2, the same data stream format is present for both the 
9x12 and 9x16 block matrix. The data stream always 
defines a full 9x16 matrix. When a device uses the 9x12 
only, the last four bits of decoded data of the second 
byte and the last four bytes of the deccded data for 
each block matrix are not displayed. For types 5 or 6, 
the deccded 10 bytes are loaded in the character matrix, 
starting from the left side of the character matrix. 


A CGLI of X'FF' indicates that this PS stcrage is free. 


A FS set of X'FF* cannot be selected Ly the operator. 


The value CHAR indicates the first slot in this storage 
to be loaded. CHAR must ke in the range X'41' through 
X'FE!. 


The storage number indicates the physical storage toa he 
loaded. Each stcrage number is related to an attribute 
selection key defined for FS. These relations are 
storage numters 02 through 07, which equate to attribute 
selection keys PSA through ESF, respectively. 


Indicates the parameters specified. If byte 7 is 
included, it must not contain the value X'00' or a value 
greater than X'06'. 


Bit 0 - When set to 1, implies that fewer than all 
points may ke displayed or printed to allow a 
performance gain for a specific device. 


Bit 1- When the CB bit is set to 0 and a local copy is 
initiated, the CGLI of this symkol set is compared with 
symbol set CGLI in the printer to determine whether 
there is a match. If the CGLIs match, the copy is 
performed using the corresfcnding CGLI in the printer. 
If the CGLIs do not match, characters from the kase 
character set of the printer are used. When the CB is 
set to 1, there is no compare and the characters are 
pranted from the base character set of the printer. 


Bit 2 - When set to 1, it signifies that this PS is 
intended for output only. The PS attribute select key 
normally associated with the storage containing this 
character set cannot be selected by the operator. 


Bits 3-7 must be set to zero. 
Must Ee set to ten for printers and nine for displays. 
Must he eight for printers and sixteen for displays. 


(If bytes 9 and 10 are not specified or are set to zero, 
a device default block matrix size of 10x8 for printers 
and 9x16 for displays is used to determine the dot 
matrix size of characters in the load PS data. The 
Qrigin cf each block matrix is chosen as the upper-left 
corner.) 


Eyte 11 Cnly 1-kyte addressing is used; must ke xX'Q0'. 


Eyte 12 For multiple-plane PS, if color (bits 5-7) is specified 
with a value b'000', then, for each code feint, the 
character definition is loaded into each plane of the 
PS. 


For a multiple-plane PS, if color is specified with one 
cof the other values, then the FS data is lcaded into the 
Specified PS plane. 


Bytes M-N These kytes contain the block matrix definition of the 
data tc ke Ilcaded. 


ee ae a ee ee ee ee > ane one a ae OO en ee ee 


To define a character, the Lyte value for the block matrix must be put 
into the data stream Ly use of bytes M-N of the structured field. A 
10x8 block matrix is ccmposed of 80 dots and a 9x16 block matrix has 144 
dots. By slicing the ktlock matrix into kytes, 8 dots te a Lyte, 
Characters or symbcls can be formed. If each dot is equal to a bit, 
then turning it on (1) allows this dot to display or print, as the case 
may be. By ccnsidering the slices as bit strings, turning each dot on 
cr off gives a hex representation which determines what is printed or 
displayed. Ccnsider the example of box "A" in Figure 1-12. Figure 1-13 
shews the slicing of the block matrix and its rit string hexadecimal 
crepresentaticn for a display 9x16 block matrix. Figure 1-14 shows the 
same for a 10x8 printer block matrix. Figures 1-15 and 1-16 give the 
structured field representaticn for Figures 1-13 and 1-14, respectively. 


Erogrammed Symkol Sets: Ali 3270 display stations and ;printers have a 
nonicadakle character set instalied in the device. A second nonloadable 
set is present if the machine has the APLyText capability. Application 
Eregrams use the characters or symbols in these sets as they are; they 
cannot alter or add to them. 


Cn the 3278 and 3279 display stations, each character is represented by 
a pattern of dots selected frcem a block matrix. The 3278 Models 2 and 3 
have matrixes of 9 dots horizontally by 16 dots vertically, while the 
3278 Model 4 and all 3279 mcdels have matrixes of 9 dots horizontally by 
1Z dcts vertically. Cn the 3287 printers, each character is represented 
cy a pattern of dots selected from a block matrix of 10 dots 
herizontally Ly 8 dots vertically. Characters are normally represented 
Ey predefined patterns accessed by character ccdes in the data stream 
that is sent to the terminal. 


Along with the nonloadakle character sets fcund in tne 3270, the 
extended 3270 data stream aliows for the storage and accessing cf up to 
Six Programmed Symkol sets, referred tc as PSA through EFSF. These 
Frogrammed Symbols sets are user-defined symktols and can te altered 
whenever required. Each Prcgrammed Symbol set can have a maximum of 190 
gtaphic symbols. they are lcaded and accessed under program control and 
may be used by the display cperator. The user may use the full block 
Matrix to design a character or symbol, allowing for a high degree of 
flexibility in the chcice of graphic symbcls, which can be used for the 
display andyor printiny of diagrams, curves, kar graphs, and special 
fonts, such as bold face and mathematical symbols, in addition to other 
special symbols. 
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Figure 1-13. Character Definition for a 
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11111111 = X'FF’ 
11111111 = X'FF’ 
11111111 = X‘FF’ 
00000001 = x‘01'. 
00000001 = x‘01' 
00000001 = x‘01’ 
00000001 = x‘01' 
00000001 = x‘01' 
00000001 = x‘01' 
11114111 = X'FF’ 
00000001 = x‘01' 
00000001 = X‘01' 
00000001 = x‘01’ 
00000001 = x‘01’ 
00000001 = x‘01’ 
00000001 = x‘01' 
00000001 = x‘01’ 
00000001 = x‘01’ 
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9x16 Display Matrix 
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'o'ovet wy roy 
00000000 = X’00” 
11111111 = X’FF’ 
10001000 = X’88’ 
10001000 = X‘88’' 
10001000 = X’88’ 
10001000 = X’88’ 
10001000 = X’88’ 
10001000 = X‘88’ 


11111111 = X'FF’ 
10. 00000000 = X‘00’ 
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Figure 1-14. Character Definition for a 10x8 
Printer Matrix 
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Figure 1-15. Structured Field Data Stream to Load a Box "A" 
from a 9 x 16 Display Matrix 
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Figure 1-16. Structured Field Data Stream to Load a Box "A" 
from a 10 x 8 Printer Matrix 


Fregrammed Symbol sets are held in special storage planes. A storage 
fFlane may ‘be a single plane or a triple plane. In certain 
circumstances, more than cne color may be used to display cr print a 
single character or symkol. Triple-plane storage is used with cclor 
devices so that more than cne color can afpfear within a single character 
position. | | 


There may be a need, in certain circumstances, to te akle tc dispflay or 
print in more than one color within a single character fosition. 
Prcgrammed Symbols enakles the user to define symbols in more than cne 
color. This is called a triple-flane set. A triple-plane Frogrammed 
Symbols set occupies three times the normal amount of storage for each 
defined character, arranged in three planes, each representing cne of 
the three primary colors - red, klue, and green. By defining only a 
Fortion of the total symbol in each color flane, the user can obtain a 
whole symbol in more than one color. Y¥hen multicolored symtols are 
required, the appropriate patterns must be defined in the three primary 
cclors, loaded using the Load PS structured field, and referenced for 
use with a X'F7' cclcr attribute type. 


Ccnsider again the box "A" example. To load this symtol in three 
colors, the structured field of Figure 1-17 would be used and, if 
referenced properly for display or printing, the symktol would print or 
display as indicated. 


A multicolored symkol could appear in various ways when displayed or 
printed: 


® If a symbol defined in a triple-plane set is displayed cr printed 
with the color attribute X'F7', the pattern defined in each color 
Flane is presented in that color. When part of a whole symkol 
appears in more than cne color plane, the colors ccmbine as follows: 


Plane in which Color of dot 

dot is defined : 3279 3287 Printer 
Red Red Red 

Blue Blue Elue 

Green Green Green 

Red and blue Pink Flack 

Red and green Yellow Black 

Blue and green Turquoise Black 

All three White Black 
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This data steam would result in the character's being displayed 


as shown below. 
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‘Blue 


@ie* ® © © & 


ee © © © © © e}/@je e © & @ 


@— Red 


© 


Green 


OOO 0000000060 
i? e¢ 8 @ ® e.6¢e @ @|e 6 6 6 @ 
© 6 @ © © © &@ Of @je 2« «© © @ 
© e@ e@ © © 80 © 8f/@je @ & @ «@ 


Figure 1-17. Character Definition of a Multicolor Symbol 


« If a symbol defined in a triple-plane set is displayed cr printed 
with an explicit cclor attribute other than X'F7' (for example, 
red), the whole symkol as defined Ly comkining all three planes is 
displayed in the specified cclor (red). 


e Tf a symbol defined in a triple-plane set is displayed or printed 
Without any color attrikute, the whole symbol appears in monochrome 
in the same way as any character. 


Unless the user loads the three planes in a triple-plane symbol set 
separately, the system loads the same pattern into all three planes. 
Thereafter, the triple-flane set behaves (fcr any character that has the 
Same pattern in all three planes) exactly as if it were a single-plane 
set. Consequently, a triple-plane set can always be used as if it were 
a Single-plane set. 


aie CO ame em EE IE <a ame oho CE ND ED ED cee ee 
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The Read Partition Cuery and Cuery Reply structured fields frovide the 
mechanism for a host application program tc request and receive 
information regarding a device's color, highlighting, usatle area, reply 
modes, and Programmed Symbcl set characteristics. 


2¢ 
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structured field is valid cnly in outbound data streams and must te the 
last structured field ina WSF transmissicn. 


The format of the Read Fartition Query structured field is: 


Eyte Bit Content Meaning 


ee woe OO age ae oe oe —_— a ee ne ae 


C-1 - X'0000" Length 
or 
X'0005! 
2 = xX'O1! Structured field tyre 
3 = X'FF* 
4 - X'Q2¢ Identifies this structured field as a Read 


Fartition Query 


If tytes 3 and 4 dec nct exist, or byte 3 dces not contain X'FF', or 
kytes exist after Lyte 4, an Cp Chk or error code is returned. If the 
outbound chain (SNA) dces nct contain CD, the chain is rejected. 


The response to the Read Partition Query is the transmission of a series 
of structured fields that describe the characteristics cf the addressed 
terminal. Response is immediate when SLELC/SNA protocols are keing used; 
resjonse is given when the terminal is polled if BSC pretocol is being 
used and, in the case cf the 3274 Model 1L[, when a Read Modified CCW is 
received (see follcwing). 
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is received by the 3274 10D as the last structured field in a WSF 
transmission, the 3274 ID returns a status cf DE and terminates the 
creration. The Time indicator in the Cperator Information Area is 
turned on, and the keykcard is lccked tc frevent operatcr interference 
with the query reply. 


If Read Partition Cuery is nct the last structured field in the WSF 
transmission, or if there is an error in the WSF data, the 3274 ILC 
terminates the operaticn with status of DE, UC, and sets the operation 
check bit in the sense [Lyte. 


Following acceptance cf the Terminal Query structured field, the 3274 1D 
generates an asynchroncus status of attention, requesting the hast to 
issue a Read Modified ccmmand to obtain the query reply. 


function is the transmissicn inbcund of a series of structured fields 
indicating the field and character attrikutes, the screen Cr page size 
and characteristics, the Prcgrammed Symbcl sets, and the rerfly modes 
available on the addressed terminal. Any or all of the structured 
fields may be transmitted, each defining a suyforted features 
Characteristic: color, highlighting, usakle area, reply modes, and 
Programmed Symbol sets. Since each structured field ccntains its own 
unigue identification, the crder in which the fields are transmitted is 
not defined. 


Cuery Reply Inbound Pata Stream: A Query Reply inbound data stream 
consists of an AID byte (X'88') defining what follows as an inkound 
structured field data stream, followed by the structured fields. Each 


structured field is of the general format: length - type - data. 
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defines the color attrikute values accepted ky the addressed terminal 
(and may be returned in an inbound data stream if the terminal supports 
read commands). Eight fairs of Lytes, one pair for each of the possible 
color attribute values, are returned to the host. The first byte of a 
Fair contains the color attribute value; the second Lyte ccntains the 
Same value if that colcr attribute is suprfrerted by the terminal or the 
default color attribute value (X'00') if it is not. There is one 
exception: the second ktyte of the pair defining the default color 
attrikute support indicates the default color that is suprferted. 


The structure is: 


Byte Bit Content Neaning 
Q-1 x'0016!° Length of structured field 
2 X'6e1t Cuery Reply structured field tyre 
3 x' eo! Identifies this guery reply as color 
4 0 E*Q? Reserved 
1 BSC! Printer only - black ribbon not loaded 
BY 1 Erinter only - klack rikbon loaded 


2-4 B'CCOCCO"' Reserved 
5 x'cs' Number of color pairs 


6-21 (terminal-derendent. Note: Possible color attribute values 
are X'0QO' - default, X'Fi' - blue, X'F2' - red, X'F3' - pink, 
X"F4"' - green, X'F5" - turquoise, X'F6" - yellow, X'F7*! - 
black for printers, white for displays) 


Possible 
Attribute 
Byte Value 3278 3287-1,2-2 3287-1C,-2C0 32/9-2B,-3E 
6-7 x*O00! X'F4t X'F7! X"'F7* X'Fut 
8-9 X'F1! X'OO!8 X'oor X*Ft! X'Fi* 
10-11 X'F2° X*OO" xtQoor X'F2?* X*Fz! 
12-13 X'F3! X'OO' x'QO! X'OQO! X'F3!° 
14-15 xX'F4q!t X*'*O00' x*QO!t X'Fqt X'Fqt 
16-17 xX'*F5! X'OO! X'OO! xX*'Qo!8 X'F5! 
18-19 xX*"F6! X'00" xXxOoO! X*QO? X"F6!° 
Z0-21 X'FT7! X*QO0" x00! X'F7° X"F7! 


As an example, the following Cuery Reply (Color) structured field might 
ke transmitted for a 3267-1C,-2C printer: 


X'00168186CO0800F7FIFIF2ZF2ZF300F4F4UFSOOFEQ00F7F7* 
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field defines the highlighting attribute values accepted by the 
addressed terminal (and may te returned in an inkound data stream if the 
terminal supports read commands). Four pairs cf bytes, one pair for 
each of the possible highlighting attribute values, are returned to the 
host. The first byte cf a fair contains the highlighting attribute 
value; the second kEyte contains the same value if that highlighting 
attribute is supported Ly the terminal, or the default highlighting 
attribute value (X'00') if it is not. There is one excepticn: the 
second byte of the pair defining the default highlighting attribute 
SUpport indicates the default highlighting that is supported. 
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The structure is: 


Byte Content Meaning 
0-1 x'ocopD' Length cf structure 
2 X'81'° Query Reply structured field type 
3 X'87! Identifies this query refly as highlighting 
4 X'O4? Numkter cf highlighting pairs 
5= 72 (terminal-derendent. Note: Possible highlighting attribute 
values are X'C0O* - default, X'F1" - Blink, X'F2' -— Reverse 
Video, X'F4' - Underscore) 
Possible 
Attribute 
Eyte Value 3278 3287-1,22,21C,-2€ 3279 
5-6 xX*"00' x'oco* x*'o0o* x'0oOo! 
7-8 X'F1° X*FI «6X00! X'F1!* 
9-10 xX'*"F2* X'F2* xXxOoO! X'F2° 
11-12 X*F4't X'F4t XtFyt X'F4t 


field indicates the size and characteristics cf the screen cr page of 


the addressed terminal. 


Screen or page size is expressed aS maximum 


width of usable area in characters (columns cr print pesiticns) and 


Maximum depth of usable area in characters (rows or print lines). 


(FOr 


a printer, the values returned corresond tc the maximum print fosition 
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The default size of the block matrix within which a character is 
presented is also defined. 


The structure i 
Fyte Bit 
0-1 = 

2 Z 
c o 
4 0-2 
3 

4-7 

5 = 
6-7 = 


Ss: 
Content Meaning 
X'17' Length of this structure 
xX'8i' Cuery Reply structured field tyre 
p ae oat ls Identifies this query reply as "usakle area." 
B'Q0O' Reserved 
B*O* Not a hard-copy device 
Bit A hard-copy device 
B'o0co1' 14-bit addressing allowed 
x*oc' Reserved 
= Width of usable area in characters LElock matrix 
x'50!% 3278-2,-3,-4,% 3219-2,;-3 
X'seyt 3216-5, 3287 
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8-9 = = Cepth of usable area in characters block matrix 
x'18? 3278-2, 3279-2 
X'20! 3278-3, 3279-3 
X'2E?* 3278-4 
X'1E! 3278-5 
X'66! 3287 
10 - X'0O0! Unit cf measure is the inch for distance 


ketween dots given for x and y directions in 
bytes 11-14 and 15-18. 


11-14 = = Cot spacing in the X (horizcntal) direction, 
expressed as a fraction; 2-byte 
numerator/2-Lyte denominator; and measured in 
the units defined in byte 10. 


X'00020089' 3278-2,-3,-4 
X'QQOA0ZE5' 3279-2,-3 
X"'0C010C64" 3287 


15-18 = = [Cct spacing in the Y¥Y (vertical) direction, 
expressed as a fraction; 2-Lyte 
numerator/2-byte denominator; and measured in 
the units defined in Lyte 10. 


X'Q0G02C085' 3278-2,-3,-4 
X'QCO2CC6F' 3279-2,-3 
X'0CO2C085' 3287 


19 - - LTefault width of block matrix, in dots 
x'gg' 3278-2,-3,-4, 3279-2,-3 
X'QA' 3287 

20 ~ _ TCefault depth cf block matrix, in dots 
x* 10" 3278-2,-3 
X'oc! 3278-4, 3279-2,-3 
X'08! 3287 

21-22 = = Character buffer size, in bytes 
X'0780! 3278-2 (1920), 3279-2 (1920) 
X'QaAQO* 3278-3. (2560), 3279-3 (2560) 
X'Or70° 3278-4. (3440) 
X'nnnn' 3287 - Dependent on installed buffer size (2K or 4K). 


Equivalent to display sizes except when byte 24 

of an LU tyfe 3 BIND command is set to X'0Q0'. Wrap 
points for the physical kuffer are then given as 
follcws: 


2K buffer - X*"O7BO" (1968) 

4K buffer — X'OEBO! (3760) 
with PS feature installed 

GK buffer — X'OFBO® (4016) 
no ES feature 


Cuery Reply (Reply Mode) Structured Field: This Query Refly structured 


field indicates the fcrm of inbound data stream that the addressed 
terminal supports. 
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The structure is: 


Byte Bit 


Q-1 = 


Cuery Reply (Symbol Sets) 


Content 
x'CCo7! 
x'g1' 
X'88 


X*CcOo!? 


X'C1'° 


X'Q2'° 


Cuery Reply identifier 
Identifies this Cuery Reply as "reply mode." 


Indicates that the terminal supfrerts 3270 
inkound data streams. 


Indicates that the terminal suprorts extended 
3270 data streams. 


Indicates that the terminal suprorts character 
mcde extended 3270 data streams. 


field indicates the number and kind of symkol sets (koth user-defined 
Frogrammed Symbol sets and IEM-defined sets) fresent in the terminal. 
The terminal storage ILI is given as well as an indicaticn of whether it 
is associated with a symbol set. The structured field consists of a 
1Z-kyte bkase and up to eight 3-byte storage descriptors, one for each 
storage area present in the terminal. 


The structure is: 


Eyte Bit 
0-1 - 
2 _ 
3 = 
4 0 
, 
2 
3 
4-7 
is _ 
6 ms 


Be 1! 


B'ccoc' 
X'COQ! 
X*OA!' 


X'Cg9! 


Meaning 


Length - includes any 3-kryte symkol set 
descriptors present 


Cuery Reply Identifier 


Identifies this guery rerfly as "symbol 
sets." 


Graphic escafe supported 

Reserved 

Lead Programmed Symbols structured field 
not supported 

Load Programmed Symtols structured field 
supported 

Load Programmed Symbols structured field 
extension not supported 

Load Programmed Symbols structured field 
extension supported 

Reserved 

Reserved 


Default block matrix width - printer 


Default block matrix width - display 
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12 


X' G8! 
re 10% 
X'4ccccood! 


x'c4accccad’® 


x'Q3! 


Default block matrix depth - frinter 
Default block matrix depth - display 


Display supports load PS data format tyre 1 
(will be x'60000000' if the 3274 has keen 
customized to support decompression). 


Printer supports load PS data format type 5 
(will be x*06CCCOCO00* if the 3274 has Leen 
customized to support decompression). Any 
other values for kLytes 8-11 are rejected. 


Length of each symbol set descriptor that 
follows. 


Tescriptors (One or mcre 3-kyte descriftors follow byte 12; a descriptor 
defines one terminal stcrage and symbol-set characteristics.) 


0 


B'cocc'® 


X'nn* 


Terminal storage identificaticn: xX'00Q' to 
X'O7'. 


Read-only stcrage containing Iy70O interface 
code symkol set. 


Read-only stcrage containing AFL/Text set 
if feature present. 


Host-loadable terminal stcrages for 
Programmed Symkrol sets. These IDs are 
specified in the load PS structured 
field. 


Read-only storage. 
Loadable terminal storage. 


Single-plane storage. 
Triple-plane storage. 


Symbols are accessed using a 1-byte code. 


Comparison of the symkol set IL of the 
Symbol set loaded in this storage with the 
symkol set ILT(s) of sets lcaded in the 
printer is allcwed (copy cpferations). 
Comparison is not allowed. 


Reserved. 


Symbol set IL. The ID currently associated 
with the terminal storage ID ccntained in 
kyte 0. Value range X'40' through X'EF* 
for valid symbol ID. A value of X'FF' 
indicates that the storage is not 
asscciated with any symbol set. 
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Feople dealing with information see it as a collection of individual 
elements. For example, what we know akout John Smith's employment may 
be a collecticn of individual elements: his name, serial number, 
leccation, and date of hire. The size of the element is the amount of 
data required to ccnvey useful informaticn. You do not think of "J" and 
"c" and "H" and "N" as useful individually, kut collectively, as the 
name JOHN. You do not think of JOHNSMITH963981BOSTONO70262 as being 
useful collectively, Lut see the elements individually: name: JOHN 
SMITH, Serial number: 963981, lccation: BOSTON, date of hire: 
C7/02/62. 


Each data element has its own characteristics. In this example, the 
serial number is 6 numeric digits and varies from emplcyee to employee. 
The word "NAME" is,4 characters, is alphabetic, is all uppercase, and 
dces not change. When people record these elements of data on fafer 
they take on such additional characteristics as position (where on the 
sheet of paper the item is written), color (what ink or medium is used), 
size of the letters, and writing style. 


In the past, when information was handled Ly a data frecessing device it 
was generally handled as an artificial entity called a reccrd. The 
ccntents and characteristics of a record were primarily determined Ly 
device requirements, and little cr no attenticn was yiven to the 
individual information elements. Data processing users had to adjust 
their thought fattern tc ccnfcorm to the machine requirements. 


The IBM 3270 Informaticn Lisplay System recognizes that pecprle deal with 
individual units of infcrmaticn. The system has been designed to 
ccnform to human needs and requirements, and it enables you to deal with 
data by individual elements cr "fields," each with its cwn individual 
Characteristics. 


You may describe data tc the 3270 on a field or character kLasis and 
specify the characteristics cr "attributes" of each individual field or 
Character. The 3270 then pfrcevides program and data control based on 
ycur individual field and character definitions. 


What Attributes May Fe Assigned to a Field 
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Fesides length, which is controlled by the fosition of field attributes, 
ycu may specify these additional characteristics with the attrikute 
byte: 


Frotecticn: A field is either protected or unprotected. When it is 
Frcetected, the operator cannot enter or modify data in any lccation 
within that field. 


In an unprotected field, the operator can enter characters cr can delete 
or modify characters that are already there. Headings, lakels, titles, 
and formats are commonly specified as protected. Any field in which the 
3270 operator should enter cr modify data must ke specified as 
unprctected. 
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In Figure 2-1, NAME: would most likely be specified as protected. JOHN 
E DCE would be specified as protected if it was written Ly the ccmputer 
and is to remain unchanged. If JOHN B DOE is to be entered or modified 
ty the operator, the attribute BJ must specify unprotected. 


Coler: If the device has the capability of displaying cr printing in 
color, then the fields cr individual characters may be defined in four 
cr seven colors, depending on whether the device has Lase-color (see 
"Fase Color™ in Chapter 1) cr extended-colcr capability. With 
extended-color capability, the device can display fields in one of seven 
colors, individual characters in one of seven colors, cr individual 
characters in multicolcrs. (See "Triple Flanes" in Chapter 1.) 

Extended Color devices can display the cclcrs white, red, btlue, green, 


Fink, yellow, and turguoise. 


The bkase-color printer frints fields in cne cf four colcrs determined by 
the existing field-protect and field-intensify attritutes. (See Charter 
1.) When the printer has the extended-cclcr capability, cclor. 
attributes can be applied to individual characters or to entire fields. 
The extended-cclor attributes are interpreted by the printers as 
follows: 


Color Displayed Cclor Printed cn 3287 
On 3279 Models 1¢ and 2¢ 
White Black cr green 

Red Red 

Blue Elue 

Green Green cr black 

Pink Black 

Yellow Black 

Turquoise Elack 


Note: The printing of Ltlack cr green, as shown, depends upon the Base 
Color (black or green) specify feature selected. 

Extended Highlighting: If the display has the capakility cf interpreting 
the extended 3270 data stream, then Extended Highlighting attrikutes 
(blink, reverse video, and underscore) can be applied tc entire fields 
cr te individual characters. In Figure 2-1, the unprotected fields 
could be underscored tc highlight them as cferator input areas. 


For printers with the ability to interpret the extended 3270 data 
stream, only the undersccre attribute can he applied tc whcle fields or 
tc individual characters. 


user-defined symbols. An oferatcr can enter alphameric, numeric, 
special characters, or user-defined symbols in an alphameric field. 


The numeric attribute is more complex; it depends upcn whether the 
numeric Lock feature is present and which keykoard is attached to the 
display. Figure 2-2 shows what characters may be entered with various 
ccmtinations of keyboards and field types. 


Re TE ee ae Ye Tea AE Te eee Tee Sen eerste eet we a eee ee eee eee coe 
{ FIELD 1 FIELD 2 FIELD 3 FIELD 4 | 
| r---4 c---1 c-~-1 c-"--1 ‘ coenen | 
| | 1 | NAME [2 |JOHN B DOE [3 |SERIAL: | 4 [ 963981 | [. «| 
oo LJ LJ ees: ome l 
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Figure 2-1. Example of Four Fields and Attribute Bytes 
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Ne 
Te. 


| Typewriter|No 


|---------- $-------- 


| Typewriter |No 


[---------- t-------- 


|Typewriter|Yes 


| Typewriter|Yes 


}---------- $-------- 


| Typewriter|Yes 


[---------- $-------- 


| Typewriter|Yes 


| 
|Keyboard| Shift 
{Keyboard |Numeric |Key 
| Type | Lock 
}---------- +-------- 


| Pressed |Type 


| 
{Field 


jor 


POPS Me TNS EGE OEE Ve ee ep tae Ee 1 


| Resulting Characters | 


SsSS=s5= ; ee qo Hessen | 
{| Displayed|Read Into| 


Protected|In Buffer|On Screen|Storage | 


jCan only enter 0-9, period, | 
jand minus sign; any other | 
[characters lock keyboard. | 


|Can only press dup key; any (| 
Jother action locks keyboard. 


|Alpha keys produce uppercase 
jalpha characters. Numeric 
{shift key produces numeric 
jcharacters. Alpha shift key 
[has no effect. 


{Numeric shift key has no 
{effect. Alpha shift key 
joverrides numeric specifica- 
{tion and allows alpha 
{character entry. 


{Alpha keys produce uppercase | 
[alpha characters. Numeric | 
jshift allows numeric charact-| 
Jer entry. Alpha shift key 
{has no effect. 


when auser eee 


[Can only enter 0-9, period, | 
[dup, and minus sign. Any | 
lother characters lock all | 
lkeys except for RESET key. | 
[Numeric shift key allows | 
lnumeric character entry, | 
lalpha shift key allows alpha | 
lcharacter entry. | 


Figure 2-2. Results cf Keykcard and Field Ccmbinations 
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When it is displayable and contains characters, those 
When it is ncndisplayable, any characters 
The nondisplayakle attrikute is 


nondisplayable. 


Characters are displayed. 
Within that field are not displayed. 


useful for entering classified or security information at a display unit 


that is in public view. 


it is not visible cn the screen. 


Nondisplayable data is accepted Ly the 3270, but 


If your 3270 system includes 3274s or 3276s, you must take certain 
precautions since these control units, unlike the 3271, 3272, and 3275, 
update screen images on a partial basis without removing previous images 
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from the screen (there is nec screen “blink"). To maintain security, 
make sure that programs 


e Send a nondisplay attribute byte prior to sending the intended new ; 
nondisflayable data to preclude its momentary appearance on the a 
screen. 


a Co not overwrite a ncndisplay attribute byte of the currently 
displayed image when partially chanjing field formats. 


All characters within a displayable field can be displayed at regular 
krightness, at a high intensity, in color, or with Extended Highlighting 
(-link, reverse video, underscore), so that they stand cut among regular 
display fields. Any of these (Extended Highlighting, Cclor, or high 
intensity) can be used tc call attenticn tc error conditicns or to | 
highlight protected or format fields. High intensity, when used on a 
color display, results in the field's being displayed in white. 
Throughout this document, in discussions on highlighting fields for 
better operator recogniticn and performance, remember that, if the 
device has the capability of interpreting the extended 3270 data stream 
functions, then color, reverse video, blink, cr underscore may be used 
to highlight fields or characters for display. Color andycr undersccre 
can be used to highlight printer output. On 3278 displays, cnly 
Extended Highlighting and high intensity can ke used. Normal intensity 
or underscore may te used fcr all input fields, so the terminal operator 
can tell at a glance which fields require operator acticn. You should 
not specify unprotected fields as high intensity since such fields may 
kecome selector-pen-detectakle (if this feature is installed) if the 
operator enters a gquesticn mark or blank as the first input character. 
Fields are specified as either detectakle or nondetectakle. When a 
field is detectable, it can ke used for selectcr-pen ocferaticns. A 
nondetectable field location cannot be detected Ly the selector pen cr 
cursor select. You are urged to designate all detectable fields as 
Frotected to prevent the operator's changing the content of the 
sensitive field. 


sends to She” computer cnly those fields that have keen entered, deleted, 
or changed by the operatcr. The 3270 keeps track of such modifications 
and uses that information tc select data to send to the ccmpfuter. If 
you wish to pass a field intc the computer regardless cf modification, 
you may assign the “modified" or "modified data tag (MI[T)" attrikute. 
However, you should ncte that the operator can change the MIT attribute 
unless you also assign the frotected attribute. 


You can decide which ccmbination of xeer inated you want within the 
limitations specified in the IBM 3270 Compcnent Descripticn. Certain 
attribute combinations produce additional characteristics. For example, 
the numeric (limiting keybcard use) and protected (eliminating keyboard 
use) attributes seem ccntradictory, but, when specified SOQCEners 
automatically skip the curscr past the field. 


You should also be aware that the computer is not limited Ly attrikutes. 
The computer can, for example, place alphabetic information in a field 
defined as numeric, or protected, or both. The operatcr dces not have 
such liberty. 


If you do not specify any ccmkination of attrikutes, a field is assumed 
to have the following attributes: a . 


Alphameric 


Unprotected 


Displayable (at regular ktrightness) ‘ 


Nondetectable Ly the selector pen cr curser select 
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a Not modified 
e For extended 3270 data strean 
= Color - Green 
= PS -Nonloadakle character set 
- Highlighting - 3270 field attribute defaults 


The attribute character for each 3270 data stream except the extended 
3270 data stream field uses a single nondisplayed and frotected 
character position on the screen and serves as a visual sefaration 
ketween successive fields. | 


A typical sign-on procedure illustrates how you might define fields. 
Figure 2-3 illustrates a simple procedure in which the ccmputer requests 
the operator to provide his name, location, and serial numker. 


FIELD 1: "SIGN-ON EFROCEDURE" 
This field is a heading which the operator should not be akle to alter. 
It is unnecessary for the words "SIGN-CN PRCCELURE" to ke returned to 
the computer when the ENTER key is pressed. This field should be 
protected, alphameric, displayed at normal intensity, not detectakle by 
the selector fen or curscr select, and not modified. All default 
attributes can be assumed, except that you must specify this field as 
protected. | 


FIELD 2: "PLEASE ENTER ... INFORMATION" 
You should specify this field as protected. Remember that the 
characteristics of a field are determined by the attribute byte at the 
keginning of the field. Field 1 and field Z have identical attrikutes 
and are adjacent to each other. You may chcose to define then 
separately and use two attrikute bytes, or you may chocse to omit the 
attribute byte at the kteginning of field 2. In the latter case the two 
headings combine to bheccme a single field of greater length. 


FIFLY 3: “NAME:" 

This field should ke pretected, alphameric, nct modified, and not 
detectable by the selector fen. The heading could be displayed at high 
intensity. Specify the protected and high-intensity attributes (the two 
deviations from the default attributes). 


<> SIGN-ON PROCEDURE 
<> PLEASE ENTER YOUR SIGN-ON INFORMATION 


NAME: > _ <> LOCATION: <> 
<> SERIAL NUMBER:<> <> 


<> WHEN ALL INFORMATION IS COMPLETE 
YOU MAY PRESS THE ENTER KEY 


Figure 2-3. Example of Attrikute Specification 
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The null area following NAME: is an input area for the operator and 
must therefore be unprotected. The 3270 marks this field as modified if 
anything is entered intc it, so you should nct specify the modified 
attribute. The default attributes (alphameric, unprotected, displayable 
at normal intensity, nct detectable by the selector pen or cursor 
select, and not modified) apply. Use a default attrikute at the 
keginning of this field. 


The maximum number of characters the operator can enter is determined by 
the length of this field. The length is equivalent to the number of 
nulls, or available positions on the screen, ktetween the attrikute 
character for field 4 and the attribute character for field 5. 


FIELD 5: "LOCATIOCN:" 
The attribute byte for this field is the same as that specified for 
field 3; protected and high intensity should be specified. This 
attrikute prevents the operator from keying a name lcnger than the 
maximum length desired. If the name is shcrter than the maximum field 
size, the operator presses the TAB key when the name is complete. The 
TAE automatically skips the curscr past pretected fields, such as this 
cne, and stops at the first character position in which data can ke 
entered (the next unprctected field). In this example, the cursor would 
ke positioned for entry of location. If the operator attempts toc key 
too many characters (a name greater than 17 characters in the example) 
the cursor is positioned under this attribute for the 18th character. 
The next keystroke attempts to destroy this attribute but fails to do so 
kecause attrikute Lytes are protected. The keykoard is inhikited, the 
clicker shuts off, and the "input inhibited" indicator is turned on. 

{The operator's attenticn is assured since this conditicn requires 
pressing the RESET key tc ccntinue. 


If the attribute byte for this field were omitted, the word "LOCATION:" 
would become part cf field 4 and would be normal intensity and 
unprotected. This is undesirable since the operator could continue 
entering name information beyond the desired maximum length and could 
mcdify the heading informaticn by entering data in the screen locaticns 
occupied by "LOCATION:". 


FIELD 6: The area follcwing "LOCATION:" 
This field is for cperator input and therefore must ke unprotected. The 
rest of the default attribute values arpzyly and so a default attribute 
may ke used. You need specify only that a field is to kegin following 
"LOCATION:". This field ends with the attribute byte at the beginning 
cf field 7, which determines the length of the field. 


FIELD 7: “SERIAL NUMBER:" 
This field, like "NAME:" and "LOCATION:", should be specified as 
Frceotected and high intensity. This also limits the locaticn field 
length to 5 characters. Ncte that if field 6, the input field for 
lccation, were defined as always being a five-character cede, field 7, 
"SERIAL NUMBER:", could ke defined as autc-skifp to save the operator 
frcm having to press TAE after filling in the location ccde. 


FIELD 8: The area follcwing "SERIAL NUMBER:" 
The null area follcwing "SERIAL NUMBER:" is an input area fcr the 

crerator and must ke unprotected. It should also ke specified as 

numeric so that if the cperatcr tries tc enter alphatetic data in the : 
field (and the keykoard has the Numeric Lock feature), the keybcard XK 
inhibits entry of the incorrect character, the keykoard clicker shuts 
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cff, and the “input inhibited" indicator appears to notify the operator 
of the error. The imprcper character does not appear cn the screen and 
the correct digit may ke entered after the cperator presses the RESET 
key. 


The serial number in the example always ccntains a fixed number of 
digits and is the last field entered. The maximum length cf the field 
is determined ky the lccaticn of the attribute for the next field. But 
the next field in the example is too far away ("WHEN ALL ... KEY"). 


Ey placing an additicnal attribute byte following input field 8, the 
cperator cannot enter a serial number that is tco long. If the 
fFositions allocated tc the serial number are filled, the next keystroke 
locks the keyboard, as in the name and locaticn fields. 


This additional length check is used here because this is the last field 
tc ke entered. If you had another field to enter after "SERIAL 
NUMEER:", it might be mcre advantageous to cmit this length check, as 
explained in field 9. 


FIELL 9: The area ketween the additional attribute described in Field 8 


and "WHEN ALL ... KEY" 


Ey definition, the additiondl attribute byte you used to delimit the 
serial number field kegins a new field. The frotected attribute alone 
is sufficient for this field, and this attrikute limits length for the 
serial number field. Ncrmally, however, prcetected (output) fields that 
fcllow fixed-length input fields should ke defined as frotected and 
numeric. The protected and numeric attribute defines a field as 
auto-skip. Auto-skip automatically positions the curscr at the location 
following the attribute byte for the next unprctected field, which is 
the next place you want to key data. This technique saves keystrckes 
for the operator. When the crerator keys the last character of the 
preceding fixed-length field, the cursor normally enters the next field, 
which may be frotected. But since the next field is auto-skip, the 
cursor skips this intervening protected field, and automatically 
positions itself fcr entry cf the next field, without an extra 
keystroke. 


FIELD 10: "WHEN ALL ... KEY" 

This field is a heading which the operator shculd not be allowed to 
Change. It need not ke high intensity and thus it may te defined as 
protected only. Field 10 dces nct autcmatically terminate when the last 
screen position is reached. The field definition continues fron the 
kottom right screen fositicn to the upper left screen fosition until the 
next attribute character is reached. This is called “wraparcund." Keer 
this in mind, particularly if you define the last field cn a screen as 
unprotected! 


Since fields 9, 10, and 1 are adjacent to each other (by wraparound) and 
all have the same attrikutes, they may ke comkined intc a single field 
by the omissicn cf attributes before "WHEN" and "SIGN-CN." The result 
is a single protected field teginning after the input area fcr serial 
number, wrapping around the screen, and terminating either at "PLEASE" 
Cr at "NAME" if fields 1 and 2 have keen previously comkined. 


Combining fields in the above manner may be ccnvenient but may cause 


ccnfusion and error if you change the screen layout later. It is a 
ketter practice to specify separate fields in all cases. 
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The panel is completely formatted when the fields are fositioned, the 

attribute bytes are all defined, and the curscr is placed. You must now 
kegin the transition frcem the visual image, or human-oriented panel, to 
the detailed data necessary for the 3270 tc implement your fanel design. 


PANEL_DESIGN 


You can think of a fpanel as a Single 3270 display screen image created 
by ycur program. (The terms "Screen" or "screen image" or “display 
image" could also have keen used.) 


If the terminal cperatcr filled in the infcrmation requested in the 
panel in Figure 2-4, he might receive another panel such as the one 
shown in Figure 2-5. 


An Example of a Seguence of 3270 Panels 


Assume you are given the assignment of designing the panels for an 
accounts receivable aprlicaticn. You are tc create the panels that will 
allow a terminal oferatcr to post a customer payment against his unpaid 
invoices. The terminal cperator will be sitting at a 3270 work station, 
removing checks and invoice copies from envelopes. If the invoice 
copies are returned with the check, the terminal operatecr will for each 
invcice enter the custcmer number, payment, and invoice numter. If the 
invoice copies are not returned, the terminal cperator will have to find 
the customer number based on the customer name and then decide which 
open invoices to apply the fayment against. It will be helpful if the 
cperator has some way to add various open invoices to find a comkination 
that totals the payment. 


The 1920-character panels that follow show one possikle solution. 


The first panel in the applicaticn is shown in Figure z-6. If the 
invoice copies come with the check, the terminal operator can enter the 
customer number, amount, and invoice number, and press the ENTER key. 


This posts the payment against the specified invoice. The terminal 
operator can then fost the next payment and sc forth; so lcng as the 
customer number and invoice number are known, only panel 1 is displayed. 


SIGN-ON PROCEDURE 


PLEASE ENTER YOUR SIGN-ON INFORMATION 


NAME: _ LOCATION: 
SERIAL NUMBER: 


WHEN ALL INFORMATION IS COMPLETE 
YOU MAY PRESS THE ENTER KEY 


Figure 2-4. An Example of a Panel 
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YOUR SIGN-ON HAS BEEN ACCEPTED. PLEASE 
QHOOSE ANY OF THESE PROCEDURES 


ACCOUNTS RECEIVABLE PF1 


PAYROLL 


PF2 


PERSONNEL 


PF3 


PLEASE PRESS THE DESIRED PF KEY 


Figure 2-5. Another Example of a Panel 


CSI 7 Ze 
—— ACCOUNTS RECEIVABLE -— 
of fF IIIN SNS 


ENTER CUSTOMER #_ CHECK AMOUNT INVOICE # 
OR CUSTOMER NAME 


PANEL 1 


Figure 2-6. Fanel 1 cf an Accounts Receivaktle Application 


If, however, no invoice is returned and the customer number is not 
known, the customer name can ke entered. The name need not te the 
complete name of the ccmpany; it can be the first name cf the company. 
In our example, the check says only "CAPITCL" so that is what the 
Operator enters. When the name has been entered, the terminal operator 
Fresses the ENTER key. The customer number is missing, sco Panel 2 is 
displayed. 


Panel 2, shown in Figure 2-7, shows all customers and custcmer numkers 
phonetically similar tc the name entered in response to Panel 1. Item 
numbers in Panel 2 allcw the terminal operator to select cne Ly using a 
corresponding Program Functicn (PF) key (see "Program Attention Keys" in 
this section). 
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ITEM CUST # NAME/ADDRESS ITEM CUST # NAME/ADDRESS 
Ok OK Ok ok ok Ok Ok ok Ok ok ok ok Ok ok ok Ok Ok ok ok Ok ok ok ok Ok Ok ok ok ok Ok ok ok ok ok Ok ok Ok ak ok Ok 


1 0010341 CAPITAL AVIATION > 0052693 CAPITOL ELECTRIC 
711 HILLSBOROUGH ST. 56 STATE ST. 
RALEIGH, N.C. MONTPELIER, VT. 


276141 05602 


0028472 


CAPITOL BAKERIES 0084362 CAPITOL FEATHER CO. 
1800 MAIN ST. 899 LOGAN ST. 
COLUMBIA, S.C. DENVER, COLO. 
29204 80217 


0034020 


CAPITOL COLA CORP 0048729 CAPITAL GLASS CO. 
1439 PEACHTREE ST. NE 121 STATE ST. 
ATLANTA, GA. ALBANY, NeYe 
30309 12201 


0041938 


CAPITAL DRUG CO. 0038492 CAPITOL HOLDING COQ. 
201 NORTH 9TH ST. 1609 SHOAL CREEK B 
RICHMOND, VA. AUSTIN, TEXAS 

23219 787041 


PANEL 2 


Figure 2-7. Panel 2, Showing the Results cf a Search cn a Customer Name 


As a result of terminal operator response to Fanel 2, Fanel 3 (shown in 
Figure 2-8) displays all ofen invoices for the identified customer. The 
terminal operator can now use the selector pen or curscr select to 
specify the open invoices tc which the payment applies. He does this by 
touching the selector fen tc the question mark adjacent to each desired 
invoice number or fositicning the curscr in the invoice number field and 
Frocessing the cursor select keys; selection is verified immediately by 
the question mark changing tc a > character. To post the fayment 
against the selected invoice numkers, the operator can select APPLY. 

If, however, the operator cannot easily tell the invoices to which the 
Fayment is applied, he can select CALC instead of APPLY. 


NNNVUVEEETEED EEE sy 


— = ACCOUNTS RECEIVABLE —— 
Pie 
CUST # NAME INVOICE # DATE (D) GROSS NET 

0028472 CAPITOL BAKERIES ? A984632 11/01/71 $182.50 $182.50 
: ? BO00312 42/05/71 $778.00 ° $778.00 
CHK AMT $4,000.00 ? BO00418 42/07/7L $98.50 $98.50 
TOT DUE $5,358.40 ? BO00964 42/11/74 $1,250.00 $1,250.00 
? B001200 12724771 $682.40 $682.40 
2? B001L439 42/25/71 $395.00 $395.00 
2 BO01800 OL/11/72 * $1,029.75 $1,009.15 
? BOO2015 01/15/72 * $982.50 $962.85 


MANUAL APPLY 
CALC NEXT 


PANEL 3 


Figure 2-8. Panel 3, Shcwing the Custcmer's Open Invoices 
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Selecting CALC displays Panel 4 (Figure 2-9); this is the same as Panel 
3 except that ACCOUNTS RECEIVABLE, which was high intensity in Fanel 3, 
is now normal intensity in Fanel 4. A new line with CALCULATOR in high 
intensity indicates the screen mode and explains the PF keys! functions. 
The terminal operator can new use the lower right-hand quadrant of the 
screen as a "scratch pad" tc figure out a ccmbination of cfen invoices 
that will total the payment check. This use of one fart of the screen 
for a separate functicn is scmetimes called a "split-screen capability." 


The calculator could ke programmed a number of different ways. It 
could, as our example illustrates, show all invoice numbers selected 
(shcwn with > in Figure 2-9) prior to selecting CALC in cne column in 
the CALCULATOR quadrant and in another column show any balance remaining 
frcem the check amount after subtracting the selected invoice numters. 

In Figure 2-9, Panel 4 is shcwn as it would appear if the terminal 
crerator had first selected four invoice numkers and then selected CALC. 
In this example, the selected invoices equal the check amount so .00 is 
shewn as the balance after subtracting the selected invcices. 


Fanel 4 shows that the CALCULATOR could alsc allow the operator to key 
in amounts and add or subtract them from the check amount (fressing PF1 
in our example adds keyed-in amounts; PF2 subtracts one keyed-in amount 
freom another). ,To start over at any point, the operator can press PF3 
to clear the calculatcr guadrant. In our example, the selected invoices 
egual the check amount, so they can now be posted. But first the 
terminal operator must leave the CALCULATOR rcutine by pressing PF4 
(RETURN). This displays Panel 5, shown in Figure 2-10. 


Fanel 5 is the same as Panel 4 except that, with the oferator having 
Signaled completion of the CALCULATOR, that word now afrears in normal 
intensity and ACCOUNTS RECEIVABLE once again appears in high intensity. 
The terminal operator can now, using the selector pen cr cursor select, 
select the invoices against which to apply the payment and then select 
APPLY to post the payment. 


Panel 6, in Figure 2-11, shcws the ACCOUNTS RECEIVABLE file for the 
customer after posting the payment, with the new Ealance and the total 
amount applied. Tc ccntinue to the next customer, the cperator selects 
NEXT and returns to Eanel 1. 


ACCOUNTS RECEIVABLE 


CUST # NAME INVOICE # DATE (D) GROSS NET 


0028472 CAPITOL BAKERIES 2? A984632 11/01/74 $182.50 $1482.50 

> BOOO3L2 12/05/74 $778.00 $778.00 
CHK AMT $4,000.00 ? BOO0418 12/07/71 $98.50 $98.50 
TOT DUE $5,358.40 > BO00964 12/11/71 $1,250.00 $1,250.00 

? BO01200 12/21/71 $682.40 $682.40 

? BO01439 12/25/71 $395.00 $395.00 

> BO01800 01/11/72 * $1,029.75 $1,009.15 

> BOO2015 O1/15/72 * $982.50 $962.85 
MANUAL APPLY SN NAAVV LEEPER PE EEE TIE E bbb ib bbb db teats / 4) 
CALC NEXT ==, CALCULATOR \PFi= + PF2= = PF3= CLEAR PF4= RET = 


fae ae ee Fe ee OO 


$778.00 -00 
$1,250.00 

$14,009.15 
$962.85 


PANEL 4 


Figure 2-9. Panel 4, Showing Use of the Calculator 
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CUST # NAME 


0028472 CAPITOL BAKERIES ? 
> 

CHK AMT $4,000.00 ? 
TOT DUE $5,358.40 > 
. ? 

? 

> 

> 


MANUAL 
CALC 


APPLY 
NEXT 


Figure 2-10. Panel 5, Showing Selection 


Calculatcr 


CUST # NAME 


0028472 CAPITOL BAKERIES 
CHK AMT $4,000.00 
TOT DUE $5,358.40 
NEW BAL $1,358.40 


OV VV 


SEL INV 


$4,000.00 


MANUAL APPLY 
CALC NEXT 


MNNAVVVGEE 
— > ACCOUNTS R 
~Zrretarnn 


INVOICE # 


A984632 
B000312 
B000418 
BO000964 
B001200 
B001439 
B001800 
BO02015 


CALCULATOR 


INVOICE # 


A984632 
B000418 
B001200 
B001439 


PANEL 5 


PANEL 6 


=— Cy 


DATE 


11/01/71 
12/05/71 
12/07/71 
12/11/71 
12/21/71 
12/25/74 
01/11/72 
01/15/72 


PFL= + PF2= - 


DATE 


11/01/71 
12/07/71 
12/21/71 
12/25/71 


$778.00 
$1,250.00 
$1,009.15 
$062.85 


GROSS 


$182.50 
$778.00 
$98.50 
$14,250.00 
$682.40 
$395.00 
$14,029.75 
$982.50 


NET 


$182.50 


$1,250.00 
$682.40 
$395.00 
$962.85 


PF3= CLEAR PF4= RET 


00 


GROSS 


$182.50 

$98.50 
$682.40 
$395.00 


of Invoices after Using the 


NET 


$182.50 

$98.50 
$682.40 
$395.00 


Figure 2-11. Panel 6, Showing New Balance after Posting 


Not all of the 3270's yfossitilities are shcwn in these six fanels and 
this example 


net all users will have the selector pen or cursor select; 


was designed only to show what panels are and how the 3270 can be used. 


Ncte that, in the above example, the terminal operator does not see as 
many panels as the programmer must create; nct all panels necessarily 
What the programmer 


aprear to the operator in any given applicaticn. 


regards as separate panels may appear to the terminal oferatcr as one 


changing panel. 
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In the above example, a numter of additicnal fanels cr variations to the 
panels shown would be required. For example, if the terminal operatcr 
Fresses an invalid PF key, a variation of the panel would ke required to 
send a message tc the operatcr over the panel presently at his display. 
In programming panels that are variations cf cne main panel, it may be 
useful to assign panel designations (for example, Panel 4A, 4B, and so 
forth) for variaticns cf Panel 4. 


Planning a Sequence of Fanels 


After an applicaticn fregram has been defined, the information that will 
ke passed between the frogram and the terminal operator must be defined. 
This information can ke thought of as output panels and infut respcnse 
to panels. Usually, ycu will be able tc approximate the sequence of 
panels. The exact sequence of output panels often depends cn the input 
response to panels. The following discussicn shows cne way to define a 
seguence of panels. 


Assuming you have a gccd understanding of the type of application 
program (such as data entry, order entry, cr inguiry) and the kind of 
information that must ke exchanged and processed (such as customer name, 
invoices, and check amcunts), you can consider which panels come first. 
Suppose the first panel required is a sign-on panel, as shcwn in Figure 
22125 


After sign-on, the next panel might allow the terminal oferator to 
choose one of several different applicaticns cr procedures that he would 
use. But what if the name cr word entered was not an authcrized 
sign-on? Another fanel might tell the terminal operator about this and 
ask him to reenter a sign-on name. Figure 2-13 illustrates a technique, 
sometimes called "klock diagramming," that may help in laying out a 
sequence of panels. 


Using the Panel Layout Sheet 


After block-diagramming the panels in the application cr pfrccedure, you 
are ready to decide cn the exact contents of each panel: the fields 
that will be in the panel, what attributes each field will have, and 
what words will be displayed in the panel. This can ke done on graph 
Faper. The IBM 3270 Information Display System Layout Sheet, Gx27-2951 


Pe DS a ae are <P a er EE YE mT cues SY ce eS ae a 


cr GX27-0014, is useful for layout. 


Cne of these sheets can ke used for each panel. After laying out a 
sequence of panels, ycu have a collecticn cf fanel layout sheets. Using 
the informaticn on these sheets and the Elock diagram showing the 
relationship between fanels, the program can be written te send the 
fanels to a terminal and handle an operator's response to them. 


Panel 1 Sion 


pane| 


Figure 2-12. Sign-On Fanel Elock Diagram 
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Sign-On: 


Panel 1 
7 panel 
Good Request 
sign-on Sign-On Panel 1A 
code ? Again panel 
Choose 
Panel 2 Program 


panel 


Figure 2-13. Block-Diagramming a Sequence of Panels 


An Example of Laying Cut a Fane 


To lay out a panel, ccnsider the sign-cn fanel shown in Figure 2-12. 

Ycu might jot down on a piece of paper the information required for the 
panel, or you might write it directly on the fanel laycut sheet. Figure 
Z-14 shows what the panel part of the layout sheet might lcok like after 
you put the text ycu wanted for your sign-cn fanel on the layout sheet. 
A 48C-character display is shown here. 


Now that you have written cut what you want the terminal oferator to 
see, you can define as fields the separate items of displayed text and 
Spaces you are allcwing for cperator input. Remember that a field is 
always preceded by an attrikute Lyte. The attrikute Lyte cccupies a 
Space on the panel even though it appears as a blank sface to the 
crerator. Before deciding the attributes of a field, insert some 
Character such as A cn the layout sheet tc indicate the space for the 
attribute byte. As ycu get used to creating fanels, you may want to 
enter the A at the same time you are laying out the text. You should 
also show the cursor lccaticn on the panel layout sheet tc indicate to 
the operator where to start his response. The cursor fosition can be 
indicated by an underscore (_) under the space where you want it to 
appear, or you might enclose the space cr characters in a rectangle. 
After adding the indications for attribute Lytes and the cursor 
position, the sign-on fanel afrears as shown in Figure 2-15. 


You could have designed the panel as one long field (or even no field at 
all), but if you did, ycu wculd not be taking advantage of the 3270's 
Capabilities. If you designate various items on the panel as fields, 
each field can have different attributes, as discussed in "What 
Attributes May Re Assigned to a Field." 


For example, you might want the fields NAME:, LOCATION:, and SERIAL 
NUMBER: to have high-intensity attrikute to focus the crerator's 
attention on them, because these fields indicate where the operator 
enters information. Ycu might want to protect the fields cther than the 
operator input fields sc the operator could nct erase them; the operator 
input fields following NAME:, LOCATION:, and SERIAL NUMEER: should te 
‘unprotected so the operator can type in infcrmation. The cperator input 
field following SERIAL NUMBER: can be numeric to allow some work staticn 
editing; the operator would not be allowed to accidentally enter an 
alphabetic character. Field length can be defined Ly. keginning a new 
field where you want the previous field to end (in some cases, this new 
field serves only to give a length attribute to a previous field). 
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COLUMN 


POsOueeoecnoso 


*[2]s[4[sfel7]sfofof[2): 


02 | Q Ni- ON, iPIRO.CED URE 


Figure 2-14. Sign-On Panel As Written Out on Layout Sheet 


COLUMN 


= ]5]7]8}2]0|)]2]3]4}5]s[7]s}s]o]:]2]3]4}s]e|7]8]9}o] ]2 


02 | S.LGNI- Ol pR.oc.€ U E | ual 


OWEN, ALL: DONE ORMAITLON iTS OW PLETE 
My —YO0, AA, PRESS, THE NTIER JEN 


Figure 2-15. Panel Layout, Including Attribute and Cursor Positions 


Having decided on these attrikutes, you can use the columns cn the right 
side of the layout sheet tec record the lecaticns and attrikutes of the 
fields you have created. Your recording in these columns might appear 
as in Figure 2-16. 


The use of these columns depends on whether the panel designer also 
codes the panels or only designs them. The information now on the 
layout sheet can be used to write a line of code that, when sent to the 
display, displays your fanel with its specified field characteristics. 
The next section, "Data Stream Coding," shows how the panel in this 
example is coded. 


a7 


Attribute 


pinee. < Rees High'| Sel | Disp | MOT o «| 2] 8 > 
Item | Row | Col j Dec | Hex | § Prot at Det i On > z F 5 2s 58 2 2 2 % 
eee $4 —— 46-1 tft 
12 14 | eS eee eee eh eae Ue os ee te eh 
‘Zio@ii | | | RS 7 Rs EE SE I HAR ERG (AT (a RC ee ee 
ey a a a (A) ON ae RR a ae ee a ae Fe eS Se ee ee ee 
Ho fe tes of foe wf ff pf ft 
1616135) | —}+—e + +$ +$ + et HH FH HS 
BoE ee ae ee se ee 
T8i7 [fe]; | [| ce ein) See GR ORE ER ERR COR ca (ee ieee se nee ee ee 
ae ee ET ———eEEE——————————— 
a ———————————————— Se RS eS (A Fa De a Se ae ee 
pa aa Ha ER (ean ae as Se ea ae ee | ee ee 
SRR Ae (Na eee He (emt aaa, A, mes ere (a CR eae FR Dae EH ees een aR a es 
Rae peep at a ff ft 4} ff tt 


Figure 2-16. Laying Cut Field Attributes 


CATA STREAM COLING 


pp com ate ae <r amen cae ae eee cee ES ep a games NL acing 


You must communicate certain information to a 3270 device cr its ccntrol 
unit so that it can use the fanels you have designed. This information 
includes commands, control characters, orders, and data. 


For the examples given telow, assume that ycu begin with a clear screen: 
all writes to the 3270 are EFraseyWrite or Erase/Write Alternate (for 
960, 2560, 3440, 3564, or, cfEtionally, 1920-character displays) commands 
and all positions are set to nulls. (Commands are discussed in more 
detail in this chapter under "The Relaticnshipr of One Lata Stream to 
Ancther." Refer to the 3270 Component Description for the command 
codes. Note that the cnly command codes used for a 3270 with VTAM 
Support are those listed under "Remote" in the command code taktle in the 
3270 Component Descrifticn.) 


Een. ae ame aun ame — ap ee aw 


Crders 


Crders (1) position, define, and format data being written to the 
device, (2) erase selected unprotected data stored in the device, and 
(3) reposition the curscr. 

These orders provide instruction to format every panel: 


4 Start Field (SF) crder: Specifies that the next character is an 
attribute character. 


e Set Buffer Address (SBA) order: Specifies an address for data and 
successive orders. 


s Insert Cursor (IC) order: Moves the curscr to the current kLuffer 
address. 
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€ Start Field Extended (SFE) order: Can generate a 3270 field 
attribute and/or extended field attribute at the current buffer 
location, and unspecified attributes are set to nulls. 


@ Set Attribute (SA) order: Provides the capability in the data 
stream of changing a current character attrikute so that 
subsequently interpreted characters inherit the current character 
attribute as updated when this order was processed. 


e Modify Field Attrikute (MF) order: Provides the capability of 
selectively updating field and extended field attrikutes at the 
current buffer address. 


These orders are included with the text, which is koth the data you have 
in your computer fcr the terminal operator, such as field headings or 
inguiry responses, and the data that the operator has that must te 
provided to the computer, such as Serial number, part number, or 
Quantity desired. The orders and text are sent to the display unit and 
are interpreted by a ccntrcol unit to which the display unit is attached. 
The control unit formats the panel text before it is actually displayed 
at the display staticn. 


The kack of the panel layout sheet is used for writing the fanel orders. 
The headings at the tcp cf the columns indicate what the cclumns should 
ccntain. 


The first six columns as shcwn in Figure 2-17 identify items in the 
text, their addresses, and the orders required to format them. The 
column headings are explained below: 


e ITEM: Refers to any part of the panel that requires one or more 
orders to the control unit tc format it. There are 11 items in the 
Sign-on panel: 


1. SIGN-ON PRCCEDURE 

2. PLEASE ENTER YCUR SIGN-ON INFOCRMATICN 
3. NAME: 

4. Input field 

5. LOCATION: 

6. Input field 

7. SERIAL NUMEER: 

8. Input field 

9. Field to limit size cf serial number input 
10. WHEN ALL INFCEMATION IS CCMPLETE 

11. YOU MAY PRESS THE ENTER KEY 


Figure 2-17. Text Items cn Panel Layout Sheet 
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It is only by coincidence that the numker of items in this example 
equals the number cf fields. Since each field requires an SF or SFE 
order, there are always at least as many items as fields. There are 
more items than fields when, for example, the SBA order is used to 
Space over unused positions within a single large field, as in Item 
11. 


e ROW, COL: Contain the starting location (row, column) address of 
each item. | 


e DEC, HEX: Are for a different addressing format which you do not 
need if you use the row, column addressing format. Therefore, you 
May use these columns fer any notes to yourself or leave them Llank. 


e ORDERS: Contains the orders you are writing, -such as SEA, SF, SFE, 
MF, SA, or IC. 


As shown in Figure 2-1&, the columns under the head ATTRIBUTES provide 
the field or character attrikutes that can ke defined. The programmer 
checks the appropriate columns of the attributes he is changing from the 
default values: 

e PROT: Protected 

e NO.: Numeric 

@ HI INT: High intensity 

® SEL PEN DET: Selector-fen-detectakle or cursor selectarle 

8 NONDISP/PRT: Not displayed (nor printed at printer) 

e MDT CN: Modified data tag on 


REV VID: Reverse video 


YEL: Yellow 


TURQ: Turquoise 


Attribute 

Non- 2 2a ry 
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Pa ESE: (AR a SEAT, MR (er NE ae See UT se 
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| SS SS RE I A: AE ea a SN Re Ss ea [ier (ee ee, ae ee 


Figure 2-18. Field Attributes 
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At the bottom of the cclumns (Figure 2-19) are the attribute values that 
are automatically frovided unless you specify a change. You must, 
however, specify a hexadecimal order value for the default attributes, 
as discussed under "Coding the Panel." The defauit values are: 


€ UNPR: Unprotected 

e A/N: Alphameric (alphaketic and numeric) 

4 NORM: Displayed at regular brightness 

e NON: Not detectakle hy the selector pen or curscr select 
2 NORM: TLisplayed (at regular brightness) 

s CFF: Not modified 


e Extended Highlighting: When used as a character attribute, the 
default assumes the characteristics of the extended field attrikute. 
When used as an extended field attribute, the default assumes the 
Characteristics of the field attrikute. 


e Color: When used as a character attribute, the default assumes the 
characteristics of the extended field attrikute. When used as an 
extended field attribute, the default is the color green. 


a FS Set: When used as a Character attrikute, the default assumes the 
Characteristics of the extended field attribute. When used as an 
extended field attribute, the default is the character set installed 
in the device. 


you are now ready to add the required orders to the panel layout forn. 
This may require that ycu rewrite the right half of the form if it was 
Criginally prepared without regard to orders or if insufficient space 

was allowed. 


Figure 2-20 shows a completed layout sheet containing all the orders to 
ke sent with the sign-cn fanel. The hexadecimal order values are 
discussed under "Ccding the Fanel" and shown in Figure z-zz. Each item 
cn the panel has Leen assigned an item number to help ycu ccrrelate the 
text with its associated crders. 


Figure 2-19. Attribute Cefault Values 
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Figure 2-20. Completed Order and Attribute Information 


Item 1. SIGN-ON PROCEIURE. To write this title, you must tell the 
control unit: 


e Where you want the title displayed on the panel. The SEA order sets 
the buffer address (SBA) to location R2, C11. 


e That this location is the start of a field. The SF order tells the 
control unit that the lccation contains an attribute byte and not a 
text character. You also indicate which attrikutes the attrikute 
byte is defining. In this case, the field is protected. The rest 
cf the attributes for the field are default attrikutes and therefore 
do not have to be changed. 


Item 2. PLEASE ENTER YCUR SIGN-CN INFCRMATION: To write this 
information, the ccntrcl unit must know cnly where the text is located. 
Therefore, you must write an SBA instruction followed Ly the address R4, 
C2. This is also the Lreginning of a protected field, sc ycu should 
include an SF order and a protected attribute. 


Item 3. NAME: As with Item 2, you must identify where this text is 
displayed. Therefore, you must write an SEA order follecwed ky the 
kuffer address R6, C1, where the text begins. R6, C1 is also the | 
keginning of a protected, high-intensity field and you should include an 
SF and an attribute as shown. 


Item 4. Input field fcr operator's name. Since this item immediately 
follows Item 3, the ccntrol unit already kncws the correct address. 
Therefore, there is no reascn to issue an SEA order. Item 4 is the 
start of a new field, hcwever, so you must issue an SF order to instruct 
the display tc expect an attribute byte next. The attrikute byte 
defines the input field as unprotected (U), alphameric (A), normal | 
intensity, not detectakle by selector pen, and no MDT on. Eecause these 
are the default attributes, you do not have to check anything in the 
attribute definiticn cclumns. 


The cursor should follcw the attribute byte to indicate where the 
crerator should begin to enter information. The Insert Cursor (IC) 
order displays the curscr at this current buffer address. After the 
display has stored the attrikute byte in location R6, C7, the new 
current address is R6, C8; this is the place where the curscr affears on 
the panel. 
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Item 5. LOCATION: The control unit must have two orders for this iten 
which (1) give the starting Luffer address (SEA) of the field as R6, 
C25, and (2) indicate that it is the start cf a new field (SF), that it 
is protected, and that it has high intensity. 


Item 6. Input field fcr operator's locaticn ccde. This iten 
immediately follows the text of the last item so there is no need to set 
the buffer address. Write cnly the SF order tc indicate the start of a 
new unprotected field, and use default attrikutes. 


Item 7. SERIAL NUMBER: This field requires an SBA to location R7, C1, 
and an SF to begin a new field. The attrikute is specified the same as 
that for Item 5. 


Item 8. Input field fcr serial number. The attrikute Lyte for this 
input field immediately follcws the last character of the frevious field 
sc an SBA is not required. The attribute is numeric only. 


Item 9. An extra field created to limit the size of the serial number 
input field. This follows the input field and is protected only. An 
SEA is required for lccation R7, C23, for proper placement of the 
attribute. | 


Item 10. "WHEN ALL ... COMPLETE." The ccntrol unit must have two 
crders for this item: an SBA order that gives the starting address of 
R10, C3, and an SF order to indicate that it is the start cf a new 
field. The attribute Lyte defines a protected field, and the rest of 
the field attributes take the default values. 


Item 11. "YOU MAY ... KEY." All the words from "WHEN ALL" through 
"KEY" could have been treated as a Single item, but 8 blank spaces would 
have to be sent hetween "CCMELETE" and "YOU" to positicn "YOU" properly 
at R11, C5. Use only the 3 characters reguired for an SBA crder and its 
associated address, breaking the field into 2 items, tc position "YoU" 
at R11, C5. 
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To write a panel in assembler language so that it can be part of the 
application program, ycu must transfer the panel's text and crders tc an 
assembler coding sheet cr tc any other form ycu find suitable. } 


Cn the coding sheet (and in your program), a panel is represented Ly a 
series of assembler [C statements, each with a name to which your 
Frcgram can refer. In the example given helow, SIGNPANL is the name of 
the sign-on panel. When the applicaticn frcgram wants to send the 
Sign-cn panel to a display unit, it issues an Erase/Write or EraseysWrite 
Alternate command and designates SIGNPANL as the panel for display. 


The display orders must ke written in the [C statements in the 
hexadecimal codes listed in Figure 2-21. Thus, SF is represented by 1D, 
SEA Ey 11, IC by 13, SFE by 29, SA by 28, and MF by 2C. 


Each part of each crder must be written in hexadecimal, including the 
attrikute byte that follcws the SF order and the buffer address that 
follcws the SEA order. The IBM 3270 Reference Summary, GXz0-1878, 
contains the hexadecimal ccdes for all the attrikute Lyte combinations 
and the hexadecimal ccde for every buffer location in both EFCDIC and 


ASCII. 
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Eegin coding with the first item on the panel layout sheet: the title, 
SIGN-CN PROCEDURE. Start with the orders for the panel text, which must 
always precede the text itself sc that the ccntrcl unit kncws what to do 
with the text. The extended data stream equivalent is written tc the 
right of the 3270 data stream coded statement. 


The first order for the title is the SEA order. Figure 2-21 shows that 
the SPA hexadecimal ccde is 11, so you write this code in a [C statement 
as: 


EC: xa 


New look up the R2, C11 address that must follow the SEA crder. The 
FECLTIC address is 40F2 and it follows the SEA code in the [CC statement: 


CC xX'1140F2' 


You should also record this statement in the buffer address HEX column 
to the left of the SEA on the layout form for possible future reference. 
You may, if you prefer, lcck up all the addresses and reccrd them in a 
Similar manner before you Legin to write your [C statements. See Figure 
-Z2 for an example. 


The next order for the title is the SF order, which is follcwed ky the 
attribute byte. Attrikutes are shown in Figure 2-23. The SF code, 1D, 
and the attribute code, 60, are read from the takle and added to the DC 
statement, which is then clcsed with a single quotation mark: 


(SF) CC xX*1140F21I60! or (SFE) FC X*1140F22901C060' 


Order 


, Sequence 


Start Field 
(SF) 


Order Code) 
EBCDIC j ASCII aye Byte 
Hex Hex | 3 


Set Buffer 
Address 
(SBA) 


Insert Cursor 
(IC) 


Program Tab 
(PT) 


Address 


Repeat To 
Address (RA) 


Erase 
Unprotected 
to Address 

(EVA) 


Address 


Set 
Attribute 
| (SA) 


Start 
| Field 

Extended 
(SFE) 


Modify 
Field 
(MF) 


Figure 2-21. Buffer Ccntre] Orders and Crder Codes 
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Figure 2-22. Sign-On Frecedtre Panel Orders and Attributes 


Following the [C statement containing the crders for the title is the DC 
statement containing the text for the title: 


(SF) DC X*'1140F21L6C' or (SFE) TC X*1140F22901C060! 
LC C'SIGN-ON EROCELURE! DC C'SIGN-CN ERCCELURE' 


Ic ccde an input field that contains no text, such as the input field 
for NAME:, write just cne DPC statement that ccntains the orders for that 
field: 

(SF) CC x'1p4c13' or (SFE) DC x'2901C94013! 
1D is the hexadecimal ccde for the SF order, 40 is the hexadecimal ccde 


for an attribute Lyte that defines an unprctected field (and all other 
default attributes), and 13 is the hexadecimal code for the IC order. 
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ATTRIBUTE BYTE BIT DEFINITIONS 


ATTRIBUTE 


S = Skip Y = Yes 
U = Unprotected H = High 
P = Protected N = Numeric 


Figure 2-23. Attribute Byte Combinations in Hexadecimal 


A CC statement can be written as two or more statements. MThe [CC 
statement above, fcr example, could be written as: 


(SF) rc x*1r40* or (SFE) [TC xX*2901CC4C 
Dc x'13! DC x'13! 


Fach item from the panel laycut sheet is ccded in this fashicn. Figure 
2-24 shows the complete code required to display the sign-cn panel. 
Except for one control character, it consists entirely cf the panel 
text, preceded by the display crders for that text. (The control 
Character is described under the heading “Write Control Character 

(WCC) .") 


Repeat to Address Crder 


The Repeat to Address (RA) crder stores a specified alphameric or null 
character in buffer locations, starting at the current Luffer address 
and ending at (but not including) the specified stop address. The 
specified stop address then kecomes the current Luffer address. You 
specify the stop address immediately follcwing the RA crder, just as you 
specify an address after an SEA order. After the stop address you 
specify the character that ycu want repeated. When attribute values are 
defined by the SA order, these attributes are applied as each repeated 
character is written intc the character buffer. Symbolically this 
appears as: 
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RA is 3C in hexadecimal. RA can repeat null characters and can erase 
selected parts of the screen. You may also use it to repeat any other 
character. To put a rew of asterisks under the last title in the 
Sign-on panel, after the [C statement for "YOU MAY PRESS THE ENTER KEY" 
you specify an SBA for R12, C1. The RA order should repeat the asterisk 
character to lccation k1, C1 (the address after the last *). This is 
noted cn the laycut fcrm as shown in Figure 2-25. 
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Assembler Language Statements for Sign-On Panel 
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_ Printer Address 
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Figure 2-25. Example cf RA Crder 


The order in the example is coded as: 


rc x'3c4040! 
Se 


If you want to delete a field already on the screen, ycu can repeat the 
"null" character to delete it. 


Write Control Character (WCC) 
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The control unit tc which the display unit is attached uses the orders 
tc format the panel. Cne centrol character for the ccntrol unit must be 
included as the first character cf every panel you write: the Write 
Ccentrol Character (WCC). The WCC is a hexadecimal code that provides 
ccntrol information fcr the control unit and defines printer information 
fcr frinting panels. The other information in the WCC specifies: 


@ Whether to sound the audible alarm. The audible alarm is an 
optional display unit and printer feature that sounds a tone at the 
display unit upon fregram request. You can request this function by 
selecting the appropriate WCC hexadecimal code. If this feature is 
not installed cn a display unit, the request is ignored. 


e Whether to restore the keyboard at the end of your fanel operaticn. 
If this option is requested, the keyboard, which locks when the 
cperator completes a panel operation, is automatically unlocked when 
the program has finished processing the operator's input. Keyboard 
restoration means the oferator does not have to press the RESET key. 


(ri 
NN) 


You might not want toc unlock the keyboard after each panel is 
displayed. For example, if you plan tc write out another panel 
kefore you want to accerft input, locking the keyktoard prevents the 
operator from entering data before it is needed. Also, after 
writing an incorrect panel, you may want to force the cferator tc 
press the RESET key to make sure you have gained his attention. 


8 Khether to reset the modified data tag (MIT). If this opticn is 
specified, the attribute bytes of all mcdified fields are reset. 
This function resets all input fields to their original (unmodified) 
status when an oferaticn is completed sc they are ready for the next 
operation. 


Each panel written to a display unit or frinter must begin with the WCC 
ta identify whether these functions are requested. 


The hexadecimal code fcr each possible WCC ccmbinaticn is shown in 
Figure 2-26. 


Note: Bit number 1 of the WCC is the reset bit and can be used to reset 
characteristics to their system defined values. Refer to the IBM 3270 


The sign-on panel data is new complete and can ke sent to the display 
unit. 


WCCs for the Display 


Start en Restore Reset Code This 
Printer Alarm Keyboard MDTs Hex Value 


WCCs for the Printer 
Code This Hex Value If You Want 
Sound 


Start Audible Restore NL and EM 40-Char. 64-Char, 80-Char. 
Printer Keyboard Codes Honored Line Line Line 


Yes 


Figure 2-26. WCC Hexadecimal Codes 
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FANEL DESIGN WITH THE EXTENDED 3270 DATA STREAM ATTRIBUTES 


Ccnsider now the example of the Sign-On Procedure panel frcem Figure 2-4. 
This panel will be designed for a color display with extended-color 
capability. 3 
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Again, this field is a heading that should not be altered and not tke 
returned to the computer when the ENTER key is pressed. This field will 
ke protected, alphameric, displayed at normal intensity, nct detectakle 
ky the selector pen cr curscr select, not modified, and blue. The SEA 
order would still be the same, but now a Start Field Fxtended order is 
used. The hexadecimal data stream would be 


X*11C15A2902CC60K2F1' 


The X'11" (SBA) sets the buffer address tc row 2, column 11 (X'C15A'). 
The Start Field Extended order X'29' indicates two (02) attrikute "type 
and value" pairs. The CO indicates a 3270 field attribute cf 60, which 
is protected with the defaults mentioned above. The 42 afprlies a color 
type with the attribute value Fl, indicating this field will be blue. 


Field 2: “PLEASE ENTER ... INFORMATION" 
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This field would have the same characteristics as field 1 and would not 
have to be defined serarately, but, if desired, this field could ke 
defined with different attributes. 


Field 3: “NAME" 


This field should ke protected, alphameric, not modified, and not 
detectable by the selector fen. Since this field will request 
information, it should be distinguished from the panel heading; 
therefore, it will be displayed with high intensity, which will be white 
cn a color display. 


The hexadecimal data stream would be X'11C6502901COE8'. This stream 
decodes as set buffer address (11) to row 6, column 1 (C650). A Start 
Field Extended order (29) with one attribute "type and value" pair (01), 
a 3270 field attribute (CO) of protect and intensify (E8). 


Field 4: The Area Following "NAME" 
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The null area follcwing NAME is an operator input area and must Le 
unprotected. As before, the 3270 marks this field as modified if 
anything is entered into it. To call the operator's attenticn to this 
field, it will alsc have the Extended Highlighting attribute of 
underscore, and the cursor will ke set at this location for entering the 
information. The hexadecimal representation would be: X'2902CO4041F413'. 
This again would be a Start Field Extended order (29), indicating twe 
"type and value" pairs (02) with the 3270 field attribute (C0) 
unprotected (40) and the Extended Highlighting attrikute type (41) of 
underscore (F4) with the cursor set (13) at the buffer address for the 
first space in the unprotected field, and with the defaults menticned 
above. 


ni 
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This field would have the same attributes as field 3, and the remainder 
of the panel would be defined in the same manner as the above fields 
with any combinaticn of attributes that suited user's requirements. To 
deviate from the akove, field 5 will be defined with some additional 
attributes besides those listed in field 3. This field will he 
protected, alphameric, non-selector-pen-detectable, and pink, and will 
klink. The hexadecinal representation for this definition would te 
X'11C6E82903C06041F142F3'. This is a Start Field Extended order (29) 
with three attribute "type and value" pairs (03), the first keing a 3270 
field attribute (C0), protected with the appropriate defaults (60), 
Extended Highlighting (41) of blink (F1), and color (42) of pink (F3). 
This same type of definition could be done for the remaining fields, all 
ofticns left to the user. 


The layout: sheet for these particular fields is shown in Figure 2-27. 


Ncw suppose the user did not like the attrikutes of the NAME field and 
decided to change them to pfrctected, alphameric, 
ncn-selector-pen-detectable, and yellow. This data stream in 
hexadecimal would ke’ ¥'11C6502CO2CO6042F6'. This interfrets as tuffer 
address row 6, column 1 (C65C) to modify the field (2C) to the 3270 
field attribute (C0), cf protected with the appropriate defaults (60), 
with the color (42) of the field to be yellcw (F6) (Item 6 in Figure 
Z-27). 


Suppose the user wanted tc change the "N" in "NAME" to a different 
cclcr, or any other aprropriate extended 3270 data stream attrikute. 
For this example, the cclor will be changed. The hexadecimal data 
stream to be issued would be X'11C6D12842F5I°5'. This interprets as 
kuffer address row 6, column 2 (C6D1) to define (modify) whatever is at 
this location (28) with the attribute type of color (42), and value in 
turquoise (F5) (Item 7 in Figure 2-27). 


Attribute 


Display | Buffer PS Set 

Printer Address § tiigh | Sei Se ee _ ou] s/s|2 ..| x |8e Pee ea Lead ey ee ee 
Item | Row 5 Prot | No. | int | Det | Prt | On : epee. |= es| a {58 eee ee ee 
| / joa lis | (esa) Bal Et GREE REE LEE 
Htea ta lege SRE et ft ft tf ph 
[2 [04 [02 | 3A) (aaa (ee REEL QR ae (A (Re (RES a (RN) (a Ce Ge 
Ma torte} emt ot ft +} HHH] |] FH] + a HHH] 
13 {o@}oi | {ewe saa) ff tt ie ee ee ee 
PSE i a a a fp ) ptt te ttt 
Aloe tor f.fppef ttt eel +} — ae ae ae 
aE anes a ee ee Sais GEES NESS (ee CNS aa arc) CAT (I) RRS (ite Dae ea KP a ee 
[5 lob |a5 | iceesiSpal | tT Pet ete ee fe ft 
ed EE ea 2 a ee De ee ee ee es Se es ee a 
[ looloi | |ewolspal =| OT CT | CT CT CT CT TT TE TT 
inane DE Dae 7 ek He Fe (eee a ed Fe (ee Ce aS Fe Fe 
Be a oY a 77 7 a Re De a Op ey HR Ee CR PR (am) (ae a ee 
pas ee ee ee ONS. aoe ee ties ee fe ey. tt ts 
BE EE a SS a: ee a ee a a ae ae a a ee ee ee 
jt fff (poe sea Ka Fae Fav (a nse rae ee) Sy [se Dae 
a SS Ce Fea RR a (ae Ra aa A, a (eT Ge He ee i 
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ty 


Figure 2-27. Layout Sheet for Extended Data Stream Attributes 
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ANALYZING INPUT DATA 
The Cperator's Response 


When the sign-on panel is displayed, the operator responds by entering 
name, location, and serial number as shown in Figure 2-28. As the 
operator keys this infcrmaticn, the entered data characters are stored 
in the display unit's Luffer and are displayed as part of the panel. 
Lata that is entered in a ncndisplayable field is stored in the buffer, 
kut does nct appear on the panel. 


When the operator finishes entering the requested sign-cn data, he 
indicates the end of this operation by pressing the ENTER key, which 
causes an automatic Read Modified command execution and sends the 
following information to your program: 


@ An attenticn code to identify that the ENTER key was pressed 
e The address of the cursor's location 


e The start buffer address code to identify the next two characters as 
addresses 


e The starting addresses cf every modified field, followed by the data 
in the modified fields | 


Figure 2-29 shows this seguence of input data, which is explained below. 


The Attention Identifier (AIL) is a hexadecimal code. Ey identifying 
this code, your program can determine in which of several rossible ways 
the operator contacted the program and determine what request is keing 
made. For example, fressing the ENTER key reguests "Please enter this 
data." 


The AID code is always the first code received from the display unit by 
ycur program. The hexadecimal codes for all AID codes are shown in 
Figure 2-30. : 


For a Read Modified, the AIL code is followed Ly the cursor address, 
which is the hexadecimal ccde for the row and column location of the 
cursor when the operatcr contacted your program. 


SIGN-ON PROCEDURE 


PLEASE ENTER YOUR SIGN-ON INFORMATION 


NAME: JOHN SMITH LOCATION: BOSTN 


SERIAL NUMBER: 963981 


WHEN ALL INFORMATION IS COMPLETE 
YOU MAY PRESS THE ENTER KEY 


Figure 2-26. Sign-On Fanel with Operator's Input 
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Figure 2-29. 
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Figure 2-30. 


Operator Action 


No action by display operator 


No Action by display operator 
(Inbound Structured Field 


identifier) 


No action (printer) 


ENTER key depressed 


PF key 1 depressed 
PF key 2 depressed 
PF “key 3 depressed 
PF key 4 depressed 
PF key 5 depressed 
PF key 6 depressed 
PF key 7 depressed 
PF key 8 depressed 
PF key 9 depressed 
PF key 10 depressed 
PF key 11 depressed 
PF key 12 depressed 
PF key 13 depressed 
PF key 14 depressed 
PF key 15 depressed 
PF key 16 depressed 
PF key 17 depressed 
PF key 18 depressed 
PF key 19 depressed 
PF key 20 depressed 
PF key 21 depressed 
PF key 22 depressed 
PF key 23 depressed 
PF key 24 depressed 


Immediately detectable field selected 
TEST REQUEST key depressed 
Data transferred from card reader 


= ep ae ee — aap cae aoe aoe a oe om: ES i <n com ame 0 a a eae mp ae eo aw 2m ee ae a ere ae 


a 
| \addx of |Text from | 
| 
| 


Jadar 


| |modif 
{SBA[ field 


T r 
of |Text from 
| |second |second 


ied|modified 
fee 


Ze iaccaatal, EP aye a ee ee ep ee ee ae ae 


AID VALUES FOR SHORT READ 


CLEAR key depressed (screen cleared) 
PA1 key depressed 


PA2 (cancel) key depressed 
PA3 key depressed 


Attention Identifiers (AIDs) in Hexadecimal Codes 
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input Data 


All the modified fields from the panel follow the AID ccde and the 
cursor address. A mcdified field is any field whose attribute byte has 
the FDT on. A modified field can ke one that was modified Ly the 
Cperator or one that was defined by you in ycur program with the MIT on 
in its attribute byte. 


When any character locaticn in an input field is modified Ly the 

crerator, the MDT in the attribute byte for that field is automatically 
turned on. An input field is not necessarily a modified field. If the 
Cperator made no entry in the SERIAL field, for example, cnly his nane, 
location, and the date wculd be sent as mcdified fields toc your frogram. 


The display unit sends all the data in a modified field except nulls. 
When an operator finishes an operation, the display unit reads through 
the kEuffer for every attrikute whose code indicates its M2PT is on. Each 
time one is found, the display unit provides an SBA code and the 
starting address (the attrikute Lyte's address plus one) of the modified 
field. The SEA code identifies to your frogram that an address follows. 
It is the same X'11' ccde that you coded in your panel to identify the 
starting locations cf the fanel's text. 


SEA Codes 


ane ae eno ae ane aor qe geen 


SEA codes identify the inccming data by crcss-referencing it to the 
ccrrect input field. 


For the sign-cn panel, ycur frogram knows that row 6, column 8 (X'C34F*) 
is the start of the name input field. When it receives the first SBA 
code (X'11"'), it checks the address that fcllows to see if it is : 
(X°C34F"). If it is, ‘your program knows the text that follcws it (until 
the next SBA code) is the oferator's name and can process the input 
accordingly. 


The first part of the input from the sign-cn fanel is as follows: 


rn 
P7CIC4 ICEL ITTIC3IP4F(IJOFHIN | SPMITITIHI...| 
Saeee! neae! OEannERT Nee ERENAS! ONO! ee Stew ew CREM Semi ae Gey! Ore Ne meee | 


The hexadecimal codes are: 


7D: The AIL code for the ENTER key (see Figure 2-30). 

C4C6: The curscr address R7, C23. The cursor is at the 
next character location after the entered serial 
nugker. 

11: The SEA (Set Buffer Address) order ccde which tells 


the program that the next 2 characters are 
addresses. (See Figure 2-21.) 


C34F:; The location (R6, C8) where the following text is 
located cn the panel. 


JOHN SMITH ...: The first modified field ccntaining the operator's 
3 name. 
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PRCGRAM ATTENTION KEYS 


Fach 3270 keykoard has at least cne program access (FPA) key that the 
cperator can use to reguest frogram attention without sending any input 
data. 


The AID codes for the EA keys are shown under a separate heading in 
Figure 2-30, because they are not followed by input data even though 
there may be modified fields on the panel when a PA key is fressed. All 
four short read codes ccnsist of just the AID code. 


Ycur program should use these keys for operator requests fcr immediate 
action such as trouble alerts or requests for termination. For example, 
the assignment of several FA keys might ke: 


PA1: Terminate current applicaticn 
PA2: Return to starting (master) panel 
PA3: Explain system message 


Frogram function (EF) keys are a keyboard feature. Your program defines 
the function that each key requests when it is pressed by the operator. 


There is a separate AII code for each FF key so that ycur frogram can 
quickly identify which key was pressed and ccnsequently which function 
was requested. When a EF key is pressed, all modified fields cn the 
panel and their addresses are sent with the AID code and cursor address, 
the same as the ENTER key. For this reason, a PF key can ke a valuatle 
time-saving device for the cperator. For example, the assignment of 
several PF keys might ke: 


PF1: Return to previous panel 

PF2:; Clear (withcut using data) and repeat current fanel 
PF3:; Set up next fanel 

PF4:; Page forward 

PF5: Page kLackward 

PF6: Return to fage #1 


SELECTOR PEN AND CURSOR SELECT INPUT AND OUTPUT 


Positicning data for selector pen (optional feature) or cursor select 
(kasic feature on the 3278 and 3276) use and setting the attribute 
characters is the same as fcr any other type of data, Eut the select 
function has additional data-stream requirements. 


A field for selector fen oferations must be defined as shcwn in Figure 
2-31. The cursor select does not require the three part character that 
must precede the selectcr fen field, although they can be fresent. 
Also, the cursor selection can ke on any character in the field. 
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| 
{| Data Preceding field (on the same line as the 
| Character SPD field). 
}------------ | | 
{| 3 Space | Three space or null characters must precede 
| Characters | the attribute byte defining the SPD field 
| {| unless the attribute byte is the first 
| | character on the line. 
}------~---~~ 
| Attribute | The attribute byte defines the field as 
| Character | displayed and selector pen detectable. (An 
| | SPD field may be protected or REGS Che ss 
| | alphameric or numeric.) 
SPD -~---~------~ 4 
(Selector | Designator | The designator character which defines 
Pen | Character | the type of operation performed by 
Detectable) | {| detection on the field. 
Field ------------- 4 
Displayed | One or more displayed alphameric charac- 
| Data | ters for sensing by the selector pen. 
| | : 
- | . 
| 3 Null | Three null or space characters are required 
| Characters | when a new field follows on the same line 
| | as the SPD field. 
}------------ 4 
| Attribute Succeeding field (on the same line as the 
| Character SPD field). 
}~-----~~---- 
Character 


| 
| 
{ 
Data | 
| 
| 
| 


Figure 2-31. Definiticn of Field for Selectcr Pen Oferaticn 


The attribute byte, the designator character (described in the next 
section), and displayed alphameric characters must te cn the same line. 
If the field is longer than cne line, cnly those characters on the same 
line as the attribute kyte can be detected Ly the selector. 


Tesignator Characters 


Designator characters define three types of selector fields: selecticn 
and two types of attenticn. Each type of field performs a different 
creration. | 


The selection field is defined by a questicn mark (?) designator 
Character. When the selector pen detects a selection field, the MIT bit 
in the attrikute byte for that field is set in the display buffer. 

Also, the designator character is automatically changed on the screen to 
a greater-than (>) sign to rrovide a visible indication to the operator 
that the detection was successful. If a mistake was made and the 
operator again detects cn that same field, the > reverts tc a ? and the 
FDI is reset. The first tyre of attention field is defined Ly a space 
or null designator character. Probing an attention field cr selecting 
it with the cursor is similar to using an ENTER key. The input 


éC 


information is released to ke read by the computer when it is ready to 
dc so. The second type of attention field is the ampersand (&) with the 
3274 or 3276 contrcl unit. Probing this field causes the frogram to 
issue a Read Modified ccmmand and obtain both the address and data of 
each field. 


Figure 2-32 shows a sample selector pen fanel that illustrates scme of 
the special input and cutput data stream ccnsideraticns. 


For cutput, an Erase/Write creates the panel. In the WCC, you enakle 
input and optionally reset the MDTsS. Next you specify an SEA sequence 
te get you to R1, C7, followed by an SF with a protected attrikute. 


This should be followed by the heading "PICK ... COLUMN" and another SBA 
to R3, C9. Then specify an SF order, followed Ly a protected 
(detectable fields may ke prectected) and detectable attribute. Next you 
need the designator "2?" followed Ly "REL": 


a aS 
| | | | | | Ss | | | F | | | | | 
icfyottLywvtdtitrtnitsbetR3st{ cI | St +t? | Rt ELC 4 
| | | | A | | | F | DI | | | | 
eee ake! mee SS ee ee Me See Ree! Scene Seen MNCRee nee! Aner Seearety meneeee! 


An SBA after "REC" to &3, Cz5, provides more than the 3 required null 
characters and positicns the SF, attrikute, and designator for "2 [TOCR". 
This type of sequence is repeated for the remaining fields to location 
R7, C28. The designatcr here must be a null or a Elank so that prcbing 
or selecting by the cursor the "ENTER" field releases the selection to 
the computer. 


As the operator uses the selector pen or curscr select, the frogram 
correlates the address of each selector-pen-detectakle field with the 
data associated with it. 


Ic combine selector-fen or cursor-select-detectakle input with keykoard 
or cursor select input, use the keyboard tc release the data to the 
Ccmputer by pressing the ENTER key or a PF key. Use of the selectcr pen 
or cursor select tc release the data, such as by selecting "ENTER" in 


COLUMN 


01 | OP clk, ONE FROM EACH! .C.0.LUIMN | 
02 

03 RED 010A 

04 2,?|BL,U.E gl?4, ,D,010.R 

“0s o,21Y.ELiL,0 al?,.6, Dolo 


Figure 2-32. Sample Panel fcr Selector Pen or Cursor Select Detection 
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cur example, transmits only the addresses of the fields in which the MDT 
was set unless you are using a 3274 or 3276 ccntrol unit in which case 
the address and data are transmitted. | | 


In the example, if you pick FED and 4 [COR the symkolic input would 
appear as follows: 


Ce a ey ee Pe RE Pe ee ee en, ee ae ee 


| Fen | | i | | | | 
{ A | Cursor | 5S | i is } I | 
i <I ¢{ ArCDR {| E | &3 {| C10 {| B {| R4 | C26 i 
i D | | A | | | A | | | 
| CN a nT en Se henna 


Shortening transmissicns by eliminating unnecessary data requires some 
caution. If you design a panel requiring both pen selecticn and 
keyboard entry, do not fut an attention designator (space cr null) on 
the panel. An attenticn designator after keyboard entry transmits only 
the address of the keyktoard input field and causes the less of its 
contents. Not having an attenticn designatcr cn the panel assures you 
that an ENTER or PF key will be used and the modified field contents 
will be transmitted (and the words "RED" and "4 DOOR" in the example). 


THE RELATIONSHIP OF ONE CATA STREAM TO ANOTHER 


The examples used so far have assumed that you started with a Elank 
screen and that you built the entire panel into your data stream with 
ERASE or WRITE commands. This approach may lead to tedious work and 
lengthy data streams, which you can avcid if the panel you wish to 
display differs only slightly from the one that is presently displayed. 


MOLIFYING EXISTING PANELS 


Suppose the displayed panel is the sign-on panel in the previous 
sections. If the operator keys an invalid serial number, you may wish 
to notify him of his error and request reentry of the serial numker 
field only. You could create a new error message panel, write it to the 
display, reguire that the operator acknowledge its receipt, create a 
special serial numker entry panel, write it, and finally read the 
corrected serial number. A ketter way might ke to use the existing 
sign-on panel. 3 


After the operator has keyed the data and it has been read into the 
computer, the screen afrears as shown in Figure 2-33. 


You would like the screen to look like Figure 2-34, 
Most of the informaticn you want displayed is already there. An 
EraseyWrite or Erase/Write Alternate command would clear the screen and 
require writing a data stream containing all the information for the new 
Fanel. You could use a Write command which modifies ear eeag: data in 
the 3270's buffer, 
To change the panel in Figure 2-33 to lcck like Figure 2-34, you would: 
1. Position the curscr at &7, C17; 


2. Replace the message beginning at R10, C5 with the error message; 


3. Change the attribute at R10, C4 to high intensity for the error 
message. | : 
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COLUMN 


Figure 2-33. Modifying an Existing Panel -- Basic Panel 
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| 10 | — 40 
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Figure 2-34. Existing Panel with Error Message 
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Jc do this the right side of your panel layout for the error panel might 
(in akbreviated form) lcok like Figure 2-35. 


ITEM 1. Repositions the cursor to R7, C17. 


ITEM 2. Changes the attrikute at R10, C4 tc protected and high 
intensity. If the designer of the sign-on panel had combined 
the original field at this locaticn with the previous field, 
the field "SIGN-CN FROCEDURE," and the following field ty 
omitting the attributes at R10, C4, R2, C11, and R4, C2, (as 
you saw under the discussion of attributes) the result would 
be undesirakle. The attribute placed at R10, C4 would begin a 
new field. This would not affect the preceding field Lut, by 
wraparound, would cause "SIGN-ON PROCEDURE" and “FLEASE ... 
INFORMATICN" to be high intensity even though they were 
neither intended tc be so, nor were they rewritten. For this 
reason you should adhere closely to the "Field Ccncept" and 
not combine fields unless necessary for efficiency; if you 
must combine fields, be very careful to avoid undesired 
results. 


ITEM 3. Repositions the data flow to correctly place the second line 
of the error message. 3 characters are used instead of 6 null 
Characters. 


ITEM 4. Repositicns the data flow for the third line cf the error 
i message. | 


Since there are twc different types of Write ccmmands for the 3274 and 
3276, you must tell the IyvC portion of your program which type tc use 
for the data stream. You may want to indicate the type you want in a 
comment in the data stream. It is suggested that you estatlish some 
ceonvention for indicating ccmmand selection by discussing it at your 
installation with the people responsible for the IyvO porticn of the 
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Figure 2-35. Panel Laycut Changes for Error Message (Keyed to Text) 
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When the operator presses the ENTER key after filling in the sign-on 
fanel, the keyboard automatically locks, as it always does after an 
operator-initiated input operation. One of the functicns cf the Write 
Ccntrol Character, which was also discussed under "Coding the Panel," is 
to enable the keybcard. You should now decide if you want the WCC at 
the keginning of the error fanel data stream to enable the keykoard for 
the operator. While it is ncrmal to enable the keyboard at this point, 
ycu Day not want to do it here. It might ke ketter for the operator to 
press the RESET key, calling further attention to the error panel. (See 
the discussion of the Copy Function for additional information for the 
3274 and 3276 control units.) 


In Figure 2-33, assume that the operator now keys "9" and presses the 
ENTER key. The "9" ccrrects the original entry error and the serial 
number field now reads "963981". What goes into the computer? The 
prior discussion of input data streams shows the basic format, but which 
fields can you expect? You know that the serial numker input field will 
ke received in its entirety, since keying the "9" caused the 3270 to 
turn on the MDT for this field, and any field which has keen modified is 
transmitted in its entirety (except nulls). 


The input field MDTs fcr NAME, LCCATICN, and SERIAL NUMEER were all 
turned on by the data entered into those fields in the Sign-on panel. 
While an EraseyWrite or EraseyWrite Alternate resets all MIIs, a Write 
does not; therefore, if you do not reset them, all 3 input fields are 
returned to the computer. Eecause not all of them have changed, all 3 
should not return to the ccmputer. You may specify in the WCC that all 
MDIs in the device are reset “off" or "not modified" (ycu should do so 
here). 


Ycu may also want to scund the audible alarm, if you have cne, with the 
error panel. A WCC te reset the keyboard, reset all MDIs, and sound the 
alarm is defined as [C X'C7*" (see Figure 2-26). You can ncw use the 
Write command to change the sign-on panel into the errcer message panel. 


existing screen image while retaining all or a porticn cf the 
information already displayed. With the Write command, you can treat 
the 3270 as a typewriter-tyrfe terminal and write your panel line Ly line 
or field by field. Using multiple Write ccmmands to create a panel, 
while technically possiktle, may create proklems. 


The operator might start keying data into the panel befcre you have 
finished writing it all to the screen. You can prevent this proktlem by 
not enabling the keykcard (see WCC above) until the last Write in the 
series. 


Using succesSive Write ccmmands to accomplish what one Write command can 
dc is an inefficient use of the communication line on remote 327Cs, and 
unnecessary I/O overhead cn local 3270s. In addition, in bcth local and 
remote use, successive Write commands without an intervening REAL may 
result ina "blinking" effect while you build up the panel. "Blinking" 
may be annoying to the operator. (The 3274 and 3276 ccntrcl units 
update screens without the Elinking screen.) 


Wherever possible, use a single Write command to avoid the 
inconveniences noted akcve. 
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The error panel shcwn in Figure 2-34 displayed the errcneous serial 
number. All the oferatcr had to do was key cver the incorrect digits. 
This may sometimes ke confusing. You might instead want tc erase cnly 
the serial number input field as shown in Figure 2-36. 


Begin again with the desired WCC. Place the cursor at R7, C17 with an 
SEA to R7, C17, follcwed by an IC order. Tc erase what was entered in 
the serial number input field, use the Erase Unprotected tc Address 
order, or EUA (watch the sequence of these letters so ycu dco not confuse 
them with EAU, which is discussed next). EFUA inserts nulls (erases all 
unprotected positicns) from the current buffer address up to, but not 
including, the specified stcp address. It will also set any character 
attributes of the nulled characters to X'00'. 


The specified stop address then kecomes the current Luffer address. The 
format of the order is similar to an SBA; the code for the order itself 
(X'12' for EUA) is immediately followed by a row and column address. 


At the first position to be erased (a result cf prior cferation) you © 
should include an FUA crder. For a terminating address, ycu may use R7, 
C23 (the first positicn after the last tc be erased). There is a better 
stcp address, however. Since EUA only erases unprotected fields, and 
Since the field beginning at R7, C23 is prcetected, it can be included in 
the range covered by the EUA. If R10, C4 is used as the stop address, 
nothing additional is erased, but you can then write the next attribute 
without using an SEA, saving three characters of transmission (see 
Figure 2-37). The current buffer address is the stop address. Any data 
cr SF order that follow go into the buffer at this address. 


EUA erases all unprotected fields within its range and can erase 
multiple fields. Suppose you wanted all three input fields erased on 
the error panel, as shcwn in Figure 2-38. 


First place the cursor at R7, C17, then "kack up" with an SEA to R6, C8 
{the name input field) kefore issuing the EUA to R10, C4 (see Figure 
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Figure 2-36. Error Message Panel with Serial Number Field Erased 
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Example cf EUA Use 


Figure 2-37. 
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On Fanel with Three Erased Fields 


Sign- 
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Figure 2 


Erasing Multirle Fields with EUA 


Figure 2-39. 
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You could have started at R6, C8 with an SEA to R6, C8, fcllowed ry the 
EUA to R10, C4. However, scmetime later in the data stream you would 
have had to "back up," probakly with an SEA to insert the cursor. 


filo noctnmenstmemtinamentinemantl Sande eeatiientesanl — aw eneme anED eaTee GUT, AED ate im SOE > ee ane aD or a aap 


In the preceding example, you wanted tc erase all unprotected data, 
reposition the cursor, and add some new titles to the sign-cn panel to 
make it an error panel. The Erase All Unprctected command: 


e Clears all unprotected character locations and associated character 
attributes to nulls 


e Resets MDTs in all unprotected fields 
® Unlocks the keybcard 
@ Resets the AID (see "Erogram Attention Keys") 


@ Repositions the curser tc the first character of the first 
unprctected field 


This command appears tc do what you want (it even does what the WCC 
would have done), but it does not write any data to the screen. fYcu 
could issue an Erase All Unprotected command before the Write command. 
Then you would just write the new titles in their proper Fositions. You 
have then issued two ccmmands to create one panel. What, then, is EAU 
for? It logically resets the panel for repetitive input using the same 
panel. Co not use EAU to change panels. 


Tata Entry Example: You can use the EAU command to change a Sign-on 
panel slightly and make it a data entry panel. Then the oferatcr just 
keys in NAME, LOCATION, and SERIAL NUMBER fcr the first employee. If an 
error is made, an error panel is shown. If there is nc errer, you may 
want to clear the input, reset the MDTs, unlcck the keyboard, and 
reposition the cursor. 


The data entry panel might appear as shown in Figure 2-40. 


COLUMN 


PEERED pS ESP ERPL EBERT 112] 


ie CE MPuloy EE DATA, IENTIEY 


| OPLEASE, EWTER Nov, EMPLOWEE, TIN FORMATION 


= as EE SE Lda cee eehoenecaneclenade 3 , = , 480} 
° oo | | 
Figure 2-40. Example cf Data Entry Panel 
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The operator keys JOHN SMITH, presses TAB, keys BOSTN, fresses TAB, keys 
963981, and presses ENTER (Figure 2-41). 


You simply send the 3270 an EAU command to unlock the keyboard. The 
Cperator then sees the same panel as in Figure 2-40. The operator may 
now key data for the next employee. You have used your knowledge of 
what is displayed already to arrive at the next panel or re-create the 
present panel. 


Refetitive Outru 


In the data entry example ycu used one panel repetitively for input of 
employee information. You can reverse the requirement and design an 
employee data screen. For this example, assume the application is 
inguiry with "browsing" capakility. Assume also that the cferator has 
previously used ancther fanel to request the informaticn for employee 
numter 963981. ‘The display might appear as shown in Figure 2-42. 


At the bottom of the fanel the operator is instructed tc use the PA1 key 
to see the next employee page, probably numker 963982. The PA2 key is 
assigned to page backwards. Remember, PA keys are assigned by the 
Frogram. Program access keys cause a short transmissicn; they do nct 
even transmit the contents cf changed fields. For an inguiry and 
browsing application, there should be no input. The PA key assures 
there is no input even if the operator changes one of the unprotected 
fields, so its use is preferred to the ENTER or PF keys. 


COLUMN 


aa Dene Ser ee i 
{s]9}o[s]2}3]4]s]e]7|s]ofo}1]2]3[4]s}6]7]8]9}o]1}2 


ag OEMP LIOVEE IDATA, EN TR 


4) OP LEASE, ENTER 1Y¥0UR, IEMPLOW EE F.o.RAKT Dio 


ROW 
oo 


Figure 2-41. Data Entry Panel with Entered Data 
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COLUMN 


| 2]3]4]5[6[7[sfo]o|r{2{3]4]5}6|7/8]9/0]]2]: 


142}3]4]5]6}7/8[9]0}: [2/3}4}s]e]7/s]a}o 


fe Lege | 
02 ' 4 MP,LIO EE DA; A | 
SA PA ATO PO FP PS DP 


OTHIS| 3, Al COMFTDEN TIAL :PIAW EL, | | 


Figure 2-42. Employee Lata Fanel 


——_ <a —- a cae cue ame 


The input fields in the previous examples are output fields in this 
example. You could designate them as protected, but if you did, you 
could not use another 3270 function called "Program Tat." The Program 
Tak (PT) order advances the current buffer address to the address of the 
first character locaticn of the next unprotected field. When the PT 
order immediately follcws an alphameric or null character (not another 
crder) in the WRITE data stream (other than the character specified Ly 
the Repeat to Address crder, which is discussed earlier), it also 
inserts nulls in all the character positions from the current Euffer 
address to the end of the current field. The PT order can ke used to 
Fage through the employee data file. 


When the operator is ready tc view the information for the next 
employee, he presses the PBA1 key. Since you want to mcdify cniy the 
present panel, not erase it cr blank the unprotected fields, you request 
a WRITE command with a WCC to unlock the keyktoard. Because you are net 
sure of the present buffer address, you might begin with an SEA order to 
R6, C8 followed by the next employee name from the disk file - JOE AMES. 
EFecause this name contains fewer characters than JOHN SMITH, the screen 
would look like this if you did not clear the remainder of the field: 


oe Salita ME |; ‘ 6 Eih (E, im: 
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You must also place the location code at lccation R6, C36. You could 
use klanks after the name and an SBA sequence, or EUA with its 
associated address. Use PT instead. Insert a PT order after the "S" in 
"AMES", The single PT order clears the remainder of the unprotected 
name field to nulls and positions for the location code. PT should also 
follow the location ccde to fosition for the serial number. The data 
stream might look like this: 


a a a a ea 
IWISt | tit t t £ FE rt t t bt t Piet tt tt 
ICIBIR6(C36(JICIE | AIMIEISITIKINIGISITITI9(31I91 8121 
ICjAl | bib @t ¢@t ttt tt t tt tt tt € 
a 


The screen would appear as shown in Figure 2-43. 


As you have seen, you can write each new panel out in its entirety with 
an Erase/Write or EraseyWrite Alternate command. You should understand 
the relationship between the past data streams and the cne you are 
ckuilding. 


COLUMN 


Sane | 
Bs OE MP LIOYiEE: DATA , 


i o, Tri Lik Flor MALL EO : OH NIF EC DiE WN F | 
se ; : 


Figure 2-43. Panel CLefined with Program Tak 
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CHAPTER 3. SCREEN MANAGEMENT 


<a ame ae ae ene ane qe 


A screen management program module is a set of subroutines physically 
separate from applicaticn frcgrams and frcem the telecommunications 
Management program module of an online 3270 system. Figure 3-1 
illustrates this relaticnshif. 


Suppert functions in a screen management program may reduce the amount 
of detail work required by the applicaticn f[rograms, and effectively use 
the features of the 3270. The separation of screen management from the 
other programs alsc allcws screen management to be modified with little 
cr no impact cn application frograms or the telecommunicaticns 
Management programs. 


Screen management might include: 
e Tecoding input data streams. 
e Dynamic building of output data streams. 


e Generating multiple I/O requests tc the Line Control Mcdule based 
upon a single request frcm an application program (that is, WRITE 
then READ). 


« Automatic paging; the application program passes multifle pages to 
screen management, which asks the line ccntrol module to write a 
Farticular page to a display, depending on the display operator's 
request. 


e Automatic copying (providing a hard copy of a display image). 


The COPY function sufpfrerts data movement between any types of device 
attached to the same ccntrol unit: display tc display, display te 
printer, printer tc display, and printer tc printer. Tc prevent copying 
information from an unauthorized device, the control unit frovides a 
program-controlled cory-lock for devices attached to it. If the first 
position of a device Luffer contains an attrikute character with the 
protected option, the ccntrcl unit rejects any attempt tc copy from that 
device. (The differences in copy functions for the various control 
units are described at the end of this charter.) 


er Telecommu- Physical TP 
Application Screen ere 
Programs Management nCeNie: peices 
Management such as BTAM 


Figure 3-1. Relaticnship of Screen Management to Teleccmmunications 
Management and Application Program 
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CECCLING ANU GENERATING CATA STREAMS 


mu Rae aiptir MN eames sane See oetiie SREP etme eT me ED saees SE. aun EE a CA ace ete ——. <r ue a eS ence oR 


The data streams sent Letween application pregrams and the 3270 ccntain 
unique orders that request farticular cperaticns by the 3270 displays 
and printers. Generalized sukroutines can ke written to assist the 
application programmer's interface with the 3270 system, and an 
interface can be built to simplify online programs. 


ihis chapter discusses several approaches tc the development of a screen 
Management module whose functions can ke used ty the application 
Frogrammer to prepare cutput data streams and to decode input data 
streams. The approaches demonstrate how some 3270 device-derendent 
considerations can be removed from the application programmer's 
responsibility. The different techniques for 3270 input cr cutrput data 
stream manipulation can be used in various combinations to suit the 
needs of the installaticn. | 


This discussion assumes that the device management routines (line 
ccntrol) discussed in Chapter 4 make the local and remote 3270 
transparent to the applicaticn program. Therefore, discussion of data 
streams in this chapter ignores all header data in the input stream up 
to and including the AIC character, and all header data in the output 
stream up to but nct including the Write Control Character (WCC). 


CECOLING READ MODIFIED INPUT DATA STREAM 


A Read Modified command for a display station with a formatted screen (a 
screen with at least cne attribute character defined) produces a data 
stream consisting cf the data from each field whose modified data tag 
has been turned cn (either Ly program contrcl or by data entered in the 
field). Each transmitted data field is preceded by the 3270 kuffer 
address where that data is lccated on the dispflay. The order of the 
fields transmitted frem the screen is from left to right for each line, 
Starting at the tor cf the screen and ending at the bottom of the 
screen. All null characters in a transmitted field are stripped out by 
the control unit during transmission. 


fhe data stream, ignoring the header information up to and including the 
AIC character, appears as: 


Ee ee ay ee Re an Ee OS Se IR Ee Oe eee te a ae eg gg pe Te 
fs | A A | ; Ss | A A | 
| B | 1 2 {| CATA {| B f{ 1 2 | ee { 
| A | | | Aa | l 
Oe Rs ee ee el er a I a eee 


If the data entered in a field is variable-length or if a field can be 
skipped by the terminal cperator, the data from a particular field ona 
given panel can aprear in a different locaticn within the data stream 
for each set of operator ingut. A Read Modified command preduces a 
Variable-length cata stream cf fixed-length fields and variable-length 
fields concatenated together. 


Each two-character screen address in the data stream 1S immediately 
preceded by a Set Euffer Address (SEA) order. The detecticn of each SBA 
order in the data stream identifies the next two characters in the 
stream aS a 3270 screen address and also indicates the end of the _ 
preceding data field. The System/360 and System/370 translate and test 
instruction (TRT) can ke used to scan the data stream and to stop at 
each main storage address ccntaining an SEA order. If the detected main 
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stcrage address of the current SBA order is known, the following 
calculations can be performed for a given data strean: 


SBA(1), ADD(1A), ALD(1E), DATA FIELD (1), 
SBA (2), ADD(2A), ALD(2E), DATA FIELL(2), 
SBA (3), 


The numbers in parentheses are used as sukscripts to provide unique 
identification: 


7 The length of data field(1) = (Address of SEA(2) - Address of SBA 
(1)) -3. 


a The two-character 3270 screen address of data field(1) can ke found 
at the address of SEBA(1) +1. 


@ The length of data field(2) = (Address of SEA(3) - Address of SBA 
(2)) -3. 


s The two-character screen address of data field(2) can be found at 
the address of SEA(2) +1. 


The two-character 3270 screen address as it afrears in the input stream 
dces not provide a direct decimal or binary numeric value that can ke 
used to calculate the relative position in the 3270 buffer from which 
the data was read. However, you can use the following routine to 
convert the 3270 address as it appears in the input data stream to a 
kinary value which directly indicates the position (relative to zero) of 
the data in the 3270 kuffer. 


Assume that R3 contains the address of SFA(1) and that R4 and R5 are 
work registers. R5 will contain the result at the end of the routine. 


ALDCNVRT EQU * 


SR R4, R4 CLEAR WORK REG 

SR R5, R5 CLEAR WCRK REG 

IC R4, 0(R3) GET FIRST ADDRESS CHAR (ADD (1A)) 

N  R4, = F'63! TURN OFF ALL EITS EXCEPT LAST SIX 

IC R5, 1(R3) GET SECOND ADDRESS CHAR (ALI (1B)) 

N RS, = F'63! TURN OFF ALL EITS EXCEPT LAST SIX 

SLL R4, 6 SHIFT FIRST ADDRESS SIX BITS TO THE LEFT 
AR R5, RG ADD THE RESULTS TOGETHER 


Fy using the above technigue, several apprcaches may be developed to a 
general purpose subroutine that decodes the variable field length data 
stream for the applicaticn frogram, and returns the data in a more 
easily processed format. 


Ncenselector Pen or Non-Cursor Select Data Streams 


> <-> an cee ee ae ee ee ae ee oe — «2 ae a. ac ae ee ee eee ae aw ee owe oe ae ew oe ee ae —— ee am aw <n <n ce em ene cen oe 


DISELAY BUFFER IMAGE TECHNICUE: By using the READ BUFFER ccmmand you can 
use the display buffer image technique to return to the apflication 
ErICgram a main storage kuffer area the same size as the display kLuffer 
(480, 960, 1920, 2560, 3440, 3564). The data read from the display is 
placed in the same relative fosition in the main storage LEuffer as it 
occupied in the display kuffer, with all other positions in the returned 


kuffer cleared to spaces. 
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For this technique, use the IRT instructicn and the 3270 address 
ccnversion routine. You must know the relative locaticns in the display 
buffer where data can ke entered by the oferator, so that the decoded 
kuffer can be processed when returned Ly the mapping sukrcutine. The 
completed layout sheet for the panel in which the operator enters data 
will give you the required addresses relative to the respective kLuffers. 


Using the image technigue, all data received from the 3270 is 
left-justified in its respective fields. This has no effect on 
fixed-length fields, variable-length alphameric fields (which are 
normally left-justified), or omitted input fields. However, you must be 
aware of variable-length numeric fields where the operator can omit 
leading zeros. 


Although the image technique requires little main storage for the 
Wapping subroutine, main storage can be wasted if the routine returns a 
complete buffer with little data. To help cvercome this froblem, the 
decoding routine can pass back to the application program, a field at 
the beginning of the Euffer. The field indicates the total length of 
the kuffer, which allows the decoding routine to use a tuffer area just 
large enough to accommcdate the relative address of the last data field 
read. 


MAPPING FROM A TABLE CF RECUIREMENTS: This mapping technique requires a 
takle assembly for each unigue input panel that the mapping subroutine 
decodes for the application program. The table provides information to 
the subroutine so that the input data stream in one main storage buffer 
can te decoded a field at a time and moved to a specified relative 
offset in another main storage buffer (the target buffer) according to 
the directions assembled in the table. The preassemkled takle could he 
used to specify the following information tc the mapping subroutines: 


1. The 3270 buffer address preceding each field, which cculd Le read 
from a particular panel. This is the buffer address as it appears 
in the data stream which corresponds to the first data fosition in 
a field, not to the buffer locaticn of the attribute character that 
defines the field. Any data fields in the 3270 input stream that 
do not have a matching kuffer address in the table would be ignored 
ky the typical mapping routine using the tatle aprroach. 


2. An offset relative to zero that provides the starting position of 
each field in the target bLuffer. This information allcws the 
application programmer to order the fields in the target buffer in 
a seguence that may or may not agree with the field sequence in the 
transmitted data stream. | 


3. A value that indicates the maximum length of each field in the 
target buffer. This information allows the mapping routine to 
truncate data stream fields that are too long for the target 
fields. The maximum field length value is also reguired if the 
Mapping routine supports right-justification of fields during | 
mapping. 


4. A flag byte consisting of bit switches that could indicate: 


e Whether left justification with lcw-crder blank padding is 
reguested 


® Whether right justification with high-order zero fill is 
requested 
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e Whether the field should be translated to ensure uppercase 
characters only 


@ Any additional functions the installation wishes to implement 
in the mapping routine 
Figure 3-2 shows scme typical logical contents of the table. The order 
cf the elements within each table entry is optional. 


Assume that you map the follcwing input data stream in hexadecimal using 
the sample table in Figure 3-2: 


1140D4F1F2F31140E8&18283848511C1C6E385A7A3 


The following target Luffer, also in hexadecimal, would ke returned to 


the applicaticn prcgram: 
CIC2ZCZCHUCSHCHCHOYOKOFOFOFIF2F3E385A7A34C40 


This approach to mapping makes the applicaticn “program's input 
Frocessing routine device-independent. 


Instead of the mapping table, you could write a macro instruction to 
Frepare the table; the macrc would convert written requests into the 
proper machine language ccnstants 


A typical format for a macro instruction to kuild the sample takle shown 
in Figure 3-2 might ke: 


MAF NAME=TAELE, FCLEL=2 

MAP ATD=(1,21) ,OFFSEI=11,MAXL=5, JUST=RIGHT 

KAP ADD= (1,41) ,CFFSET=1,MAXL=10, JUST=LEFT, TRAN=YES 
MAP ADD=(1, 71) ,CFFSET=16, MAXL=6, JUST=LEFT 


Ncte: The ADD parameter specifies the 3270 kuffer in row and column 
nctation relative to one. For example, kuffer position zero equals row 
1, column 1. The cffset values are expressed relative to cne. The 
Macro instruction can have default options; for example, if JUST=RIGHT 
is not specified, JUST=LEFT can be assumed. 


a Ra a a a aa al 1 
| TABLE DS OH | 
| ENTRY1 bc X*'40D4" ACTUAL 3270 ADDRESS FOR POS 20 | 
| pc H'10! RELATIVE OFFSET IN TARGET BUFFER | 
| DC HL1'5' MAX FIELD LENGTH OF TARGET FIELD | 
{ DC X"8&0° RIGHT JUSTIFY, NO TRANSLATE FLAG | 
| ENTRY2 DC X*40E8*" ACTUAL 3270 ADDRESS FOR POS 40 | 
{ Dc H‘'O* RELATIVE OFFSET IN TARGET BUFFER | 
| DC HL1‘10* MAX FIELD LENGTH OF TARGET FIELD | 
| DC X*"4O0* LEFT JUSTIFY, TRANSLATE FLAG | 
| ENTRY3 Dc X'C1iC6" ACTUAL 3270 ADDRESS FOR POS 70 | 
| Dc H‘15° RELATIVE OFFSET IN TARGET BUFFER | 
| DC HL1'6' MAX FIELD LENGTH OF TARGET FIELD | 
| bc X"00' LEFT JUSTIFY, NO TRANSLATE FLAG { 
| ENDOLIST DC X'FF‘ END OF LIST INDICATOR | 
|---------~------~------------------------------------------------------ { 
| Note: 3270 buffer addresses in the table are shown relative to | 
| buffer location zero; relative offsets in the target buffer are | 
| shown relative to zero. | 
De ag a I a eek J 


Figure 3-2. Table of Reouirements 
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The following example shows the logic flow fcr a table- driven input 
Mapping technique: 


1. Find the 3270 buffer address of a data field to be processed in the 
input data stream using the TRT instruction. 


2. Determine the length of the data field in the data stream using the 
techniques discussed in this section. 


3. Search the takle cf reguirements, using the 3270 buffer address 
found in step 1 as a search argument to find a matching entry. 


4. Add the offset value frcm the entry found in the table to the 
starting address cf the main storage map kLuffer, tc produce the 
main storage address of the start cf the receiving field. 


5. If the length of the data field determined in step 2 is greater 
than the maximum field length value in the entry found in the 
table, go to step 10. 


6. Check the flag byte in the entry found in the table. If left 
justification is requested, go to step 10. Otherwise proceed to 
step 7 for right justification. 


7. Move zoned decimal zeros to the receiving field, using the field 
starting address determined in step 4. Use the maximum field 
length value in the entry found in the takle as the pengta for the 
move. 


8. Develor a new main storage address for the start of the receiving 
field to accommodate the reguest for.right justification. The 
right-justified starting address for the receiving field = (field 
starting address determined in step 4 + maximum field length value 
in the entry found in the table) - length of the data field in the 
data stream fcund in stefp 2. 


9. Move the data field from the data stream to the main stcrage 
address develcred in step 8, using the length of the data in the 
data stream determined in step 2. Return to the start of this 
routine to find the next data field in the data stream. 


10. Move blanks tc the receiving field using the starting address of 
the field as determined in step 4. Use the maximum field length 
value in the entry found in the table as the length fcr tke move. 


11. Move the data field fren the data stream to the receiving field 
using the field address determined in step 4. Use the length of 
the data in the data stream (determined in step 2) as the length 
for the move. 


12. Check the flag byte in the entry found in the table tc determine if 
uppercase translation is requested. If it is not requested, return 
to the start cf this rcutine to find the next data field in the 
data strean. 


13. Translate the data in the receiving field to uppercase, then return 
to the start of this routine to find the next data field in the 
data stream. The translaticn can be dcne in two ways: 


e Use the TRANSLATE instruction with the translaticn table built 
to ccnvert lcwercase alphabetic characters to uppercase. 
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e Use the OR instruction to place blanks in the field. This will 
Change the [TUF and FM characters. The FM appears as a; on the 
screen, but affrears in the data stream as X'1E'. It will be 
converted to a true ; that is, X"5E'. The DLUP aprears as an * 
on the screen, kut appears in the data stream as X'1C'. It 
will be ccnverted to a true * (X'5C"'). 


Immediate Selector Pen or Cursor Select Lata Stream 

When a Read Modified ccmmand is executed fcr a display station as a 
result of an immediate detection Ly the selector pen or curser select, 
the resulting data stream ccnsists of address strings that identify 
which fields cn the screen have the modified data tag set; the 3274 and 
3276 control units alsc transmit the modified data if the frofer 
designator character is used. 


The data stream, ignoring the header informaticn up to and including the 
AIL character, appears as: 


eee = 
is | A A | S { A A | | 
{| E | 1 2 {| B f{ 1 2 at eg. Ae 
| A | | A | | | 
a ee 


If the operator keys into a field and an immediate selectcr field is 
selected, the keyed data is not transmitted. However, if keyed data is 
entered by the operatcr, delayed selector fields are selected, and the 
ENTER key or a PF key is pressed; then the address and data for all 
fields, whether selected or keyed, are included in the data stream. 


You can use a subrcutine to free the applicaticn program from 
determining which fields were selected on a panel. A takle can ke built 
that consists of the 3270 buffer addresses, giving the location of each 
selectable field on a fanel. The mapping routine can then ccmpare the 
addresses in the table, and return to the application program a list of 
indicators that identifies the selected fields. 


The list of indicators can ke returned to the applicaticn frogram. A 
string of one-position fields can be used, and each positicn can 
indicate with a unigue character that a field was selected. The first 
fFosition in the returned list can be marked if a field in the data 
stream has the same address as the first element in the address table; 
the second fosition in the returned list can ke marked if a field in the 
data stream has the same address as the second element in the address 
takle. The application program can then determine which relative 
positions in the list have keen marked to determine which fields have 
keen selected by the operator. 


Fecause the input from a display using selectcr pen or cursor select 
detection is a series cf fixed-length addresses, the mapping routine can 
analyze the input stream and deccde it. 


For example, using the selector panel illustration in Figure 3-3, assume 
that the operator has selected the delayed-detectable fields located at 
row 5, column 10 and row 3, column 26 and the immediate-detectakle field 
located at row 7, column 18. The input data stream transmitted in 
hexadecimal from the display would he: | 


11C01E911C2E911C4C1 
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Figure 3-3. Example cf Selector Pen Panel 


Using the sample table in Figure 3-4, the mapping routine returns a list 
in hexadecimal to the application progran: 


HO6F4O4O6F4OGF 


This list indicates that the second, fifth, and seventh fields were 
selected. Note that the addresses of the selected fields afpear in the 
data stream in the same sequence as the fields appear in the display 
buffer. When a selectcr pen panel is designed by columns, the address 
cf the field selected from the first column may not occur tefore the 
address of the field selected frcm the seccnd column in the input data 
stream. 


You can write a macro instruction similar tc the one used to build the 
takle in Figure 3-2 tc kuild the selector pen takle:. 


MAP NAME=SELTAELE, MOLEL=1 
MAP ADD= (3,10) 
MAP ALL=(3, 26) 
MAP ADD= (4, 10) 
SELTABLE EQU * FOR MODEL 1 DISPLAY 
pc X'C1D9' ROW 3 COL 10 
pC X'C1E9" ROW 3 COL 26 
pc xX'c2c1' ROW 4 


a 
| 
| 
COL 10 | 
4 COL 26 | 
5 COL 10 | 

pC X*'C2F9' ROW 5 COL 26 | 
7 COL 18 | 

E STOP INDICATOR | 

| Note: The 3270 addresses used in the above table correspond to the | 
| buffer position of the Selector Pen designator character in a field, | 
| not to the iocation of the attribute character which defines the | 
| | 
J 


field. 


Figure 3-4. Sample Mapring Table 
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Mixed Read Modified Input Data Streams 


When some keyed input and scme delayed selector fen or cursor select 
detection occur in a panel during the same input operaticn from a 
display, you can use the takle-driven mapping technique for 
nen-selector-pen cr cursor select panels. Specify the table elements 
so that all delayed selector fields have a maximum length cf one 
Character. The mapping routine places the first character from the 
appropriate data stream field into the target field. The first 
character in a delayed selector field that has been selected is always a 
(>); that is, X'6E'. The application program can examine the target 
buffer for that character in the proper target field tc determine if the 
field has been selected. 


EUILLING OUTPUT LATA STREAMS 


The 3270 reguires specific kit patterns for order sequences, control 
characters, and buffer addressing. The data streams can be prepared in 
several different ways. A data stream to ktuild a static fanel (a panel 
which will always te displayed in exactly the same manner) can be 
assembled in an application [rogram as a set of data ccnstants. A 
semi-dynamic panel, which may occasionally be modified cr added to, can 
have the static portion assembled in the application pregram and have 
the program dynamically modify or add to the data stream. A data stream 
for a dynamic panel (a fanel with a high degree of change) must te 
created or assembled as a unit at executicn. This section discusses how 
tc reduce the considerations of device-dependency required to sufrort 
static, semi-dynamic, and dynamic output data streams. 


You can write macrce instructicns to simplify the preparaticn of static 
data streams for the 3Z270. One approach is tc write a set of macro 
instructions in which each macro instruction prepares a single crder 
sequence. Another afrroach is to write cne macro instruction that can 
Frepare all tyres cf order sequences, tut p[repares only cne sequence for 
each execution of the macro instruction in a frogran. 


A sample macro instruction cf the first type might ke: 
$MOL MODEL = 1, Zz, 3, 4, 5 
This macro instruction sets a global value so that the specified model 
number is used until ancther $MOD macre instruction is encountered. The 
mcdel number is reguired to correctly calculate 3270 kuffer addresses. 
The buffer address X'Czr’5' represents column 4, row 30 for a Model 1 
disjlay, and column 2, row 70 for a Model 2 display. 
The following are alsc examples of the first type of macro instruction: 
$SBA (1,10) generates the SEA order sequence X'1140C9! 
$SF (PRCT,NUM, SKIP,MCDT,HI,CET,NONDISF) 
generates an SF order (X'1D*) followed by the appropriate 
attribute character defined by the options selected in 


parentheses. Notice that if PROT is not specified, unprotected 
is assumed; if numeric is not specified, alphameric is assumed. 
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SRA (1,10,'*") generates the RA order sequence X'3C40C95C', 
SEUA (1,10) generates an EUA order sequence X'1240C9', 
$WCC (RESET,RESTCRE, ALARM, PRINT, 4OCHAR, 64CHAR, 80CHAR, NLEM) 


generates the proper WCC, depending cn the options selected in 
parentheses. 


$CCC (PRINT, 4OCHAR, 64CHAR, 80CHAR,ALARM,ATT, UNPROT,FROT, ALL) 


generates the proper copy control character (CCC), depending on 
the options selected in parentheses. (The CCC identifies the 
type of data to be copied.) 


$IC generates X'13! 
$KBD KEYBOARD = AEL or Text 


Used with the Lata Analysis feature tc identify the keyboard 
providing 3277-2 display input. 


$SI generates the Suppress Index character, valid for the 3288-2 or 
3289 printer. Cther printers receive | (the or kar) in place of 
the Suppress Index character. 


After you have defined the macro instruction, the data stream required 
to build the sign-cn panel shown in Figure 2-12 could be created as 


fclleows: 
SIGNOCN $MOD MOLEL=1 
SHCC (RESET,RESTORE) 
$SEA (2,11) 
SSF (ERCT) 
CC C'*SIGN-ON PROCEDURE! 
$SEA (4,2) 
$SF (PROT) 
DC 3 C*ELFASE ENTER YOUR SIGN-CN INFCRMATION!® 
$SEA (6,1) 
$SF (ERCT,HTI) 
CC C'NAME:' 
SSF 
$IC 
$SEA (6,25) 
$SF (PRCT, HI) 
DC C'LCCATICN:* 
SSE 
$SEA (7,1) 
$SF (PRCT,HI) 
DC C'*SERIAL NUMBER:*® 
SSF (NUM) 
S$SEA (7,23) 
$SF (PRCT) 
$SEA (10,4) 
$SF (PROT) 
DC C'*WHEN ALL ... ENTER KEY' 
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You could also write the seccnd type of instruction, a single 327C data 
stream macro instructicn, which might have the format: 


re re re a a OS wT Ere ge eae pe ee Cnn Oa ee ge ee SY Gre FO ie en ee Oe Ne ay ey ee hp ee ge ee gee 

| | | , (attributes) 1 | 

| {symbol]) | S$MAC | of-type' , (row,column) { ,character ] ,MCLCEL= 2 | 

{ I [ 3 | 

| | [ 4 | 

a sn i a a escent pel 
symkcl 


specifies a symkol that refers to the data stream 


op-type 
specifies the type of screen control operation to generate. Valid 
values are: SF, SEA, IC, RA, EUA, WCC, and CCC. 


(rcw,column) 
specifies the row (1 tc 43) and column (1 to 132) where the 
cperation starts or ends (depending on the op-type). This parameter 
is required for op-types SBA, RA, and EUA. 


(attributes) 
indicates attributes cr ccntrol bits fer SF, WCC, and CCC: 
Some valid values for SF are: ERCT, SKIP, NUM, MULT, HI, CET, 
NONDISP. 


Some valid values for WCC are: RESET, RESTORE, ALARM, PRINT, 
GOCHAR, G64CHAR, 8SOCHAR, NLEM. 


Some valid values for CCC are: FRINT, 4OCHAR, 64CHAR, SOCHAR, 
ALARM, ATT, UNPROT, PROT, ALL. 


Character 
specifies the character used in the RA function. 


KCLEL= 
indicates the model cof 3270. This model number is used to calculate 
the buffer address. This parameter is specified only cnce in the 
first macro instruction cf a data stream series or whenever the data 
stream to be generated is for a different model than the preceding 
series. Model numkers 3 and 4 can be specified only fcr the 3278 
Display Station. 


After you have defined the macro instructicn, the data stream required 
tc create the sign-on fanel shown in Figure 2-14 could te as follows: 


SIGNON $MAC WCC, (RESET,RESTORE) , MODEL=1 
$MAC SEA, (2,11) 
$MAC SF, (PROT) 
DC C'SIGN-CN EROCEDURE® 
$MAC SEA, (4, 2) 
$MAC SF, (ERCT) 
DC C'PLEASE ENTER. YOUR SIGN-ON INFORMATION! 
$MAC SEA, (6,1) 
$MAC SF, (PROT, HI) 
DC C'NAME:! 
$MAC SF 
$MAC Ic 
$MAC SBA, (6,25) 
$MAC SF, (EROT,HI) 
[Cc C'LOCATICN: * 
$MAC SF 
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SMAC SEA, (7,1) 


$MAC SF, (ERCT, HI) 

CC C'SERIAL NUMBER:' 

$MAC SF, (NUM) 

$MAC SEA, (7,23) 

$MAC SF (ERCT) 

$MAC SEA, (10,4) 

$MAC SF, (ERCT) 

cc C' WHEN ALL ... ENTER KEY! 


These two types of macro instructions can generate either a total static 
data stream or static secticns of data streams that can be dynamically 
assembled at execution Ly the application progran. 
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A semi-dynamic panel reguires some dynamic mcdification. Ferhaps an 
eLrror message must be written to a particular part of the panel and the 
cursor must be moved tc the input field in which an error was detected 
during editing. The application program can concatenate preassenmtled 
static data stream segments into the program, such as field error 
messages. The same macro instructions that build static data streams 
can -Euild partial static streams. As the input from a panel is edited, 
the standard error message for each field can te assemrtled in the output 
kuffer, thus allowing multiple brief messages to be sent tc the display 
in cone operation. 


You may have to change cne cr two attribute characters from high 
intensity to low intensity and erase the unprotected fields on a 
display. For example, an error message segment may have changed a field 
tc high intensity to call the operator's attention to the field; the 
operator has recognized the error and re-entered the correct 
information. The display must now be made ready for the next input cn 
the panel. Concatenate the crder stream segments to change the 
attribute characters and use the Erase Unprotected to Address (EUA) 
order to restore the panel; do net transmit all the data and orders to 
ccmpletely refresh the fanel. 


It may become physically impossible to hold in main storage all fossible 
output data and crder stream combinations that could occur during the 
execution of an application. You can incorporate a subroutine into 
screen management to accept parameters from an application frogram to 
decode the parameters and tc create the data stream. You can also write 
for the application prcegram a macro instructicn that Euilds a parameter 
list inline frcem entries you specify in the macro instruction, and then 
kranches to the screen management routine to kuild the required orders 
and data in the kLuffer area. | 


The macro instruction could appear as follows: 

SBUILD ALL=ACLLIFIELL,ATI= (R3) ,DATA=(R4) , LEN=(R5) 
The ALDFIELD contains the 3270 buffer address in either row-column 
fcormat, binary offset, or 3270 address form. R3 contains the address of 
the attribute byte, R4 ccntains the address of the data tc ke entered in 


the field, and R5 contains the length of the data. The attribute 
Character parameter is optional. 
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The subroutine could ccnvert row and cclumn buffer addresses relative to 
cne to decimal offsets relative to zero with the following formula: 


Model 1 Buffer: ((R- 1) X40) + (C-1) 
Medel 2, 3, 4 Euffer: ((R-1) X80) +(C-1) 


If the row and column tuffer addresses relative to one are in two 
Single-byte areas in Linary, the conversion to kinary cffsets relative 
to zero can be coded as follcws: 


SR R3,R3 

IC R3, COLUMN 

BCTR R3,C 

SR R4,R4 

IC R4,RCW 

BCTR R4,C 

MH R4,=H'4O' USE VALUE OF 80 FOR MODEL 2 
AR R4,R3 RESULT IN R4 


The following subroutine converts a binary halfword that represents the 
offset relative to zere cf a position in a 3270 buffer to an equivalent 
two-character 3270 address. R3 is a work register, and R4 fFoints to the 
binary halfword to be ccnverted. The converted result is found at 
ANSWER. 


LH R3,C(R4) 
STC R3,ANSWER+1 
SRL R3,6 
STC R3, ANSWER 
NI ANSWER+1,X'3E? 
TR ANSWER (Z),TAE 

ANSWER DC x'0C008 

TAE DC X"'4CC1CZC3IC4UCSCEC7TCBCI4AYE! 
CC X'4C4DGE4F50L1D2D3D4D5D6D7* 
DC X" D8D95A5B5C5L5E5F606 1E2E3' 
CC X "EGESEGETESE96AGBGC6DGEGF ! 
DC X'FCF1IFZE3F4FSF6F7FSF97A' 
DC X"7ETCTLIETE® 


Large Screen Siz 


Application prcgrams written for systems that use 480- cr 1920-character 
screen size will run cn large screen displays with the same width Eut 
With a greater number cf lines. Terminals with large screen capacity 
(960, 2560, 3440, and 3564 characters) will automatically default to 
smaller screen size unless the large screen size has been specified 
explicitly by the applicaticn program. The Frase Write Alternate 
command is used to switch a display intc large screen mcde. 


Since buffer address wrapping is screen size dependent, applicaticn 
fFrograms should not defend cn buffer wrap during write cperations. Also 
field attributes must ke appropriately placed to delimit the end of the 
screen image. 
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Copy Function for the 3271, 3272 
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Many applications require complete and unaltered hard ccpy (printout) cof 
the terminal's current screen contents for the display station operator. 
The ~rinter on which the display contents are printed may support cne or 
more display staticns, depending on the 3270 ccnfiguration. 


When using the copy function to oktain a printout on a 3288-2 or 3289 
printer, remember that varicus print belts can be installed on these 
printers. 


You should define a Prcgram Attention key so that a terminal operator 
can request hard copy cn an assigned terminal printer. The screen 
management program can te nctified of the cperator's request and perform 
the appropriate action. 


When a data transfer tc the ccmputer occurs from pressing a Program 
Attention key, a remote BSC 3277, 3275, 3276, 3278,or 3279 transmits AID 
and cursor address, a lccal 3277 only transfers the AID (Attention 
Identifier) character. The AID character identifies which key 
transferred the data. No screen data is transmitted, sc the program is 
notified of a specific request. 


Cnce the request is identified by inspecting the AID character, the 
Frcogram must identify the type of unit that made the ccry request. This 
can ke done by examining the characteristics cf the specific device ina 
terminal characteristics takle that you can create. fFcr example, 
depending on the type cf device, the following procedures can be used to 
Ereduce hard copy: 


e To copy from a remcte 3275 to the frinter attached to the 3275, the 
program should send WCC ro the 3275. The WCC (Write Ccntrol 
Character) restores the keyboard, starts the printer, and prints 40 
or 80 characters fer line. Eecause the printer attached to the 3275 
uses the same Luffer as the display, all that is necessary to print 
the buffer (which contains the screen data) is the start cnet bit 
in a WCC sent in a valid WRITE command sequence. 


@ To copy from a 3277 attached to a remote 3271 to a printer attached 
to the same 3271, the program should send the following data strean 
to the printer: STIX, ESC, COPY command, CCC, from-device address, 
ETX. The CCC (Copy Control Character) specifies start frinter, the 
option to copy all data, and either 40 cr 80 characters per line. A 
model 2 display cannot ke copied to a model 1 printer, Lut all other 
copy combinaticns are valid. The device address following the CCC 
is a single-character address which identifies the device to ke 
copied from, and which is identical with the device address used to 
specifically pcll the display requesting the copy function. 


The COPY command allows the buffer ccntents of a device attached to 
a 3271 to be copied to the buffer of another device attached to the 
same 3271, without moving the data to be copied to and from the 
computer. Once the pricr data stream has keen sent to the printer, 
the program should send the following data stream tc the display 
station that requested the copy: STX, ESC, WRITE command, WCC, ETX. 
The WCC restores the keyboard. The cperator has a fositive response 
that the request has heen honored, and the keykoard allows the 
operator to continue without manual intervention. 
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@ To copy from a local 3277 to a local terminal printer, the program 
should execute a Read Buffer command to the display that made the 
copy reguest. The Read Buffer command is executed, and the display 
station transmits AIL, a two-byte cursor address, and the screen 
data to the computer. The program shculd then remcve the AIL 
Character and the cursor address from the received data and, 
immediately preceding the remaining data, insert a WCC that 
specifies start printer and 40 or 80 characters per line. The 
altered data stream bLeginning with WCC should then be sent to the 
Erinter tc copy the data. The program should then send a WCC with 
the restore keykcard oftion to the display that requested the copy 
function. 


If the program determines that the receiving frinter is busy, and the 
requested copy functicn cannot be immediately completed, one of the 
following actions should he taken: 


S275 Notify the terminal operator of the situation and ask 
the operator to wait or cancel the reguest. 


3271 or 3272: Perform a Read Buffer to bring the screen data into the 
computer where it can be queued until the frinter is 
availatle, without delaying the operatcr. 


3274 AND 3276 COPY FUNCTION 


The 3274 and 3276 control units operating in BSC mode can frocess the 
CCPY command identically with the 3271 control unit. However, these 
ccntrol units can alsc handle the local cory function as fcllows: 


1. With the 3274 a lccal copy can ke initiated Ly using the Print key 
and the print authcrization matrix. A lccal copy invclves the 
transfer of data directly from the display ktuffer to the printer 
buffer and its suksequent printing. 


Z. The host can initiate a copy via the print authorization matrix by 
setting the start-frint bit in the WCC cf a write command. 


THE PRINT AUTHCRIZATICN MATRIX FCR THE 3274 ANT 3276 


With the excepticn of p~rocessing the BSC ccfy command, the print 
authorization matrix is always used by the 3274 and 3276 ccntrol units 
for copy operaticns, that is, to direct data from a display to a printer 
attached to the same ccntrol unit. For the 3274 the print authorization 
matrix allows each installation to define destination, printer mode, and 
Classes of print devices and to authorize their use Ly displays attached 
to the same control unit. The 3276 uses a default matrix to control 
this. 


The definition of a class of printers can be based on physical 
Characteristics, location, or security of the printer. For example, in 
a particular installaticn class, "72" may have been defined as referring 
tc all printers with a text character set and yellow paper. Thus an 
operator may select an authcrized printer cn the basic of these 
characteristics rather than Ly address. 


The print authorizaticn matrix allows a maximum of 16 classes to ke 
defined in each suksystem. In any configuration a single printer can be 
in one class, or several classes, or none. A destinaticn device may be 
in one of three modes specified in the print authorization matrix: 


= eee ae en ame cans maze ou ease 
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A frinter in local mode is used solely for operator-initiated local copy 
functions. This means that displays within the cluster can contend for 
use of printers but the host cannot. The printer is not availakle for 
direct print operaticns from the host. A frinter in local mode using | 
ESC also is unavailable to the host via the COPY command. In particular 
a printer in local mode cannct validly be specified as a "from" device 
in a COFY command. 


A local copy can be initiated by an operator, using the Print key on the 
3274, or by the host when the printer is operating in shared mode. [In 
ESC mode the start-print bit in the WCC or a WRITE command to the source 
display initiates the copy cferation. 


A printer in system mode is entirely under host (system) ccntrol. The 
printer cannot be used fr oferator-initiated local copy requests. The 
printer is likewise not available for host-initiated copy cperations. 
However, when operating with BSC the printer can honor a CCEFY command 
when in system mode. The CCEY command directed to the "to" device 
specifies "from" device as a command parameter. The print authorization 
matrix is ndét used to direct the copy operation. 


THE MATRIX STRUCTURE 


The print authorizaticn matrix consists of a numker of destination 
device descriptors with the following format: 


oe ee ee ee ee 


ie 
{| Destination Address | Mode | Class | Source Device List | 
i a a Is ee clk sical ee me ei cee eee eS 


SP EO i a RP ee EP EP a a Ee ane ase ae. ene eu are 


Addresses from 1 to 7 fcr the 3276 and 1 to 31 for the 3274 allow 
printers to be attached to any port on the control unit (port 0 
cannot be used fcr a frinter). Addresses are sequential, by 
adapter. 


Mede defines the frinter to be in lccal, system, cr shared mode. 


to group printers into classes. This field is bit-coded, one bit 
for every 16 classes so that a single printer can te in more than 
one class. Valid classes are designated 70 through 85. 


source Device List is a kit-coded field that specifies which 
displays are authorized to use the printer associated with this 
device descriptor. Each bit positicn is associated with a port 
number on the cluster. 


A printer can belong tc cne cr more classes, and several frinters can 
kelcng to a single class. It is important to note that source devices 
are associated with destination devices, nct with classes. Thus several 
Frinters may be defined to ke in class 75, kut a particular display can 
cnly be authorized for scme subset of all frinters in that class. When 
class identification is displayed in the indicator row of the display, 
copying is performed cnly tc authorized printers in that class. 


The print authorizaticn matrix is required to perform lccal copy 
operations. If the matrix is not loaded in the 3274, all printers are 
in system mode, and local ccry operations are not possitle. (The 3276 
has a default matrix.) The exception occurs during BSC line discipline, 
where the host can initiate a local copy Ly sending a COPY command to 
the printer. | 
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CLEFINING THE MATRIX 


The matrix must be defined Ly the applicaticn frogram at the host system 
and loaded into the suksystem as follows: 


1. The operator at the display attached tc fort zero initiates a 
transaction with the hcst program responsible for defining, 
Managing, and loading the print authorization matrix. This 
transaction may, through appropriate interaction with the operator, 
define a new print authcrization matrix, redefine an existing 
Matrix, or retrieve a previously defined matrix from storage. 


2. The applicaticn prcegram must then transmit the matrix data to the 
display as normal application data, in a data stream that resides 
in the regeneraticn buffer as normal character data. 


3. The operator then holds down the ALT key and presses the Erase End 
of Field (EOF) key con the keyboard. This will cause the buffer to 
ke scanned one character at a time and the configuraticn data tc he 
stored in internal form in the control unit. 


During the loading precess, the Wait indicator is displayed and the 
keyboard is lccked. If the lcad is successful, the Wait indicator is 
turned off and the keykcard unlocked. The operator can then return to 
normal activity. Local frinting can take flace according tc the 
authorization established in the matrix. If the loading frocess fails, 
the Frogram Check indicator is displayed and the keyboard remains 
locked. The operator can reset the keyboard and resume operation. Only 
those device descriptcrs that have been loaded take effect. 


The applicaticn program must ensure that correct matrix data is loaded. 
If invalid data is loaded, unexpected results may occur when the matrix 
is used by the subsystem. Loading of the matrix will terminate 
abnormally only when there is a format violaticn. 


When the operator initiates the load operation from the keykcard, the 
print authorizaticn matrix wust appear in the buffer as shcwn in the 
follcwing text. 


The first two lines of the display are reserved for the use of the host 
Frogram to display descriptive information to the display cferator. 
These positions are nct scanned during the lcad process. 


There must be a sequential string of attrikute characters, keginning at 
the first character fesiticn cn the third rew of the display (buffer 
address X'AO') as follcws: 


| one Pome Te Se nay ay OPP RE es ees TOR OB ee ee Oe tee ere he Ba ee gee pap ee Ce Cn ee ee ae 
| Eits | Pret { Alfha | MDT | High | ! Ncn | 
{| 23 4567 | Unprot | Numer | | Inten | Sel Pen | Lisp jf 
(-——— +—-—-——---—----+}-___--—_}---—_}------ a ee 
{ 10 C000 | E { i i { i A 
; 0O 00071 | u | | yes | { [ i 
; 01 C100 | u | n | i H yes | i 
{| 16 O0COO | F { { i | i i 
| een i ee a a a ce a I ase es le 


This 4-byte sequence uniguely identifies the buffer data that follows as 
Frint authorization data. If the sequence does not aprear exactly as 
shown, the load precess will nct occur. The remainder cf the third row 
is not scanned. 
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The remaining rows of the display contain the destinaticn device 
descriptors. One descriptcr is contained in each row. The format of 
each descriptor is as follows: 


~~ ee eT Pee te ee ee Oe ee Ng A aN coe eee tga cee ae ee — 
1 Col 1 Cel. 2. 3 i Col 4 { Ccls 5-20 | Cols 21-52 { 
t--——— (Sy ee saapecazacaa | 
{| Protected | Address {| Erinter | Erint | Source Device | 
j Attribute- | cf Printer- | Mode -- | Class -- | List -- 32 { 
| cone byte { two Lytes j one byte | 16 Lytes {| bytes : { 
Osc a i a i ee eee 


The protected attribute, '110 0000', defines the next 51 bytes as a 
destination device descriptcr. If it does not appear in the first 
column of the row, a fcrmat violation cccurs and the loading fprecess 
will terminate at this point. 


The two bytes immediately following the attrikute provide the 
character-coded decimal address cf the printer being described. For 
example, the printer at port 03 is identified Ly the character data 
'C3', X'FOF3". Addresses are not validated at the time the matrix is 
lcaded. For example, the device at the specified address must not he a 
Frinter. 


Erinter mode is expressed as follows, as a 1-character field: 


_ Mode Character Hex (EBCDIC) 
Local L C3 
System S E2 
Shared J D1 


Any other coding of this Lyte results in the printer's keing defined as 

unaccessible for either local-cofy or direct-frint oferaticns. There is 
ne validation of this Lyte during loading cf the matrix. If there isa 

conflict between the mcde definition and the ccding of the source device 
list, the mode byte takes precedence. 


The next 16 characters define the printer classes that are applicable to 
the device. Ey apprepriate coding of this field, a device can ke 
defined for multiple classes. Each character in this field is defined 
tc ke a character-coded digit representing one entry in the class field 
of the device descriftcr. 


Display Column Class 
5 7C 
6 71 
7 7z 
8 73 
9 74 

10 75 
11 76 
12 77 
13 78 
14 79 
15 aC 
16 81 
17 82Z 
18 8 3 
19 84 
20 85 
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The character 1, EECLDIC X'F1', in one of these character fecsitions 
defines the device keing described as a member of the class associated 
with the corresponding fositicn in the class field of the device 
descriptor. Any other character in this position means that the device 
is not in the asscciated class. 


The scurce device list is a 32-byte field. Source devices authorized 
for printers are character-ccded. The character '1', ERBCLTIC X'F1', in 
any character location specifies the associated device as an authorized 
source device for the destination device defined. Other values in this 
location indicate that the associated device is not a valid source 
device. 


Display Column Device Address 
21 00 
22 01 
23 02 
24 03 
25 04 
26 05 
27 06 
28 07 
29 08 
30 09 
31 10 
32 11 
33 12 


Each descriptor takes 52 bytes, including the attrikute Lyte; thus, each 
rCW contains 52 bytes cf significant infcrmation. Other data on the row 
is not scanned during the lcad process. The first descriptor kegins at 
kuffer address X'OCFC', the second at X'0140', etc. 


The end of the matrix is signaled by the following sequence of attrikute 
btytes beginning in the first column of the row following the last valid 
destination device descriptor: 


c LOTR OL ST Te Oe ee eg re Sue re ee ea A Ge pe ge eee de 
{ Bit {| Prot | Alpha | MDT | High | Sel Pen { Neon | 
{ 23 4567 | Unprot | Numer | | Inten | Detect | LDisfp | 
t-— ff eee 2 laces == 
; 10° ccoo | E i l | i l [ 
| 00 0101 | u | y | | y | | 
| ©1 6707 | u i n i y | | Y | [ 
| CO C100 | u [ { | i y | l 
t. a I ee ee eee ee J 


After the print authocrizaticn matrix is loaded the operator initiates a 
lecal copy, using the Frint key on the 3278 keykoard. Print data frcem a 
terminal is always directed to the authorized printer in the associated 
Frinter class. Ey using the Print IDENT key, however, the display 
cperator can alter this defined associaticn frem the display keyboard. 

A new print class can ke selected by pressing the Print IDENT key and 
keying in a two-digit class identificaticn number between 70 and 85. 
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The host applicaticn frogram can initiate a local cory function in 
shared mode by sending to the display a WRITE command with the start 
Frint bit turned on the WCC. The control unit performs the local cory 
function as required, using the print class assigned tc the display. 
When a write-type command is sent to the display with the start-print 
bit on, the display first interprets the crders and data in the write 
data stream, and then updates the display tuffer. 


: On copy operaticns, if the required disrflay and printer features 
ot match, the desired printed output may not result. 


CO GEE GED epeED eine «ERD ee eumnee er). ame ane ae ee ae ae ee > me oe > om ae au oe 


Frograms written for the 3271/72 using the Katakana character set might 
enccunter problems in certain instances if run on the 3274/76. The 
3274/76 control units handle four characters differently from the 
3z71/72. These characters are #, .'', ", -. The table below summarizes 
the handling of these characters. : 


aa aaa aaa aa a aa aa la are a a mer ater | 
{} 2274/76 {1/0 {| 3271/72 { Hex Code i 
{Characters {Ccde | Display { Back to Host | 
et SS 
i # (pound sign) | 4A i x LC | 55 | 
| ! | SA | le 56 | | 
{ " | 7F i space i nothing j 
| = { Al | Space i 00 i 
a a a a a ae i ere et ae eer 


The 3271/72 handle code 7F as the escape ccntrecl character used with NL 
(new line) and EM (end of message). Although the character " will 
display as blank, the frinter will treat it as NL or EM. ‘Thus, systems 
that have a mix of 3271772 and 3274/76 ccntrcl units should avoid using 
the four characters. 


This chapter, a supplement to the 3270 information in the ETAM and 
ETAM-ES manuals, descrikes scme aspects of the support BTAM and BTAM-ES 
provide. (Chapters 5 and 6 describe TCAM and VTAM support.) It 
discusses how you might manage devices and keep track of device status, 
and how BTAM and BTAM-ES analyze 3270 operations and perform error 
recovery. Before writing any application programs that use BTAM and 
BIAM-ES macro instructions, however, refer to the BTAM and BTAM-ES 
publications and the cther 3270 publications listed in the preface to 
this book for a more ccmplete description of BTAM and BTAM-ES support 
for the 3270 display system. Use of the term BTAM throughcut this 
chapter is meant to include ETAM-ES. 


TELECOMMUNICATIONS MANAGEMENT WITH BTAM 


<a> a cee cer a ee CO Pee see eo ee oe cee eee eee BO. wee a eS cE aS me eh em cca a ae Se EE cee eee 


ETAM provides support for the 3270 under both DOS and DCS/VS and OS, 
CSYVS1, and OS/VS2. ETAM-ES provides support for the 3270 under 
COS/VSE. BTAM and EBTAM-ES support local 3272, 3274-1B, 3274-1D, and 
remote BSC 3271, 3274-1C, 3274-51C, 3275, and 3276. This support 
includes generating channel frograms for the 3270, starting and 
Supplementing I/C operations, handling attentions and line 
interruptions, and performing error recovery. 


Using BTAM as part of the telecommunications management of a 3270 
display system involves several factors, including the following: 


@ Different devices on the lines have different characteristics. 
8 Application prcegrams reguire informaticn contained in the data 
stream. 


e Screen management should receive the same data from a 
telecommunications management program, regardless of device type, to 
maintain a standard interface. 


BIAM and BTAM-ES include suffrort for the extended 3270 data, which 
includes the Write Structured Field command, Prepare to Read, and 
transparency macros. 


WRITE STRUCTURED FIELT (WSF) 


This command causes a 3274 (with the capability) to enter Write 
Structured Field mode. This operation transfers a data stream 
ccntaining structured fields to a specified device. The structured 
field contains a type field that determines device action. 


Lecal 3270 operaticn devices unable to supfort structured fields, that 
is those attached to a 3272 or 3274-1B Control Unit, will reject the 
Write Structured Field with a command reject error. On the 3274-1D, 
excerpt for the optype, operands for this macro are the same as thcse for 
the WRITE ERASE macro instruction. The optyre for the WSF macro is TSF. 


For remote 3270 operations, Write Structured Field reguires data 
transparency because full 8-bit kytes describe many of the device 
actions. Data transparency means that data, including normally 
restricted data-link line-control characters, are treated as specific 
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bit patterns. Thus, any bit pattern can be transmitted as information 
data and not as line-control data. To enter transparent mcde, use the 
WRITE transparent macrcs. 


If contact has not been previously established with the selected device, 
a WRITE TIE or WRITE TIX is issued, with the entry operand specifying 
the address of the device's entry in an addressing terminal list. If 
contact is already established, a WRITE TTE or WRITE TTX is issued, and 
the entry operand is nct applicakle and should ke omitted. In kLoth 
cases, the area operand specifies an output area containing: 


Gee a a ae ee en Grol he ae ee a ene 8 ee 
{| DLE | STX | ESC { 3% | Structured Field(s) | DLE | ETX or ETB | 


i ee a ee ane San aaa | 
This is X'F3' in EBCDIC 


1. The DLE ETX or DLE ETB characters are supplied Ly BTAM when the 
application program uses BTAM transparency macro instructions. 


2. Any application program using Write Structured Field should return 
the device to its 3270 default mode before terminating. This will 
avoid starting a second application program, which may not use WSF, 
with the device in WSF mode. To reset WSF mode, issue an FRASE 
WRITE or ERASE/WRITE ALTERNATE command with a WCC of .1.. .... BTAM 
will automatically reset WSF mode during a Request for Test (RFT) 
processing. ETAM CPEN and LOPEN routines will also reset WSF mode. 


FREPARE TO READ OPERATIONS (PTR) 


The Prepare to Read operation applies to local 3274 Model 1D devices. 
Prepare to Read does nct affrly to the 3272, 3274-1B, or remote 3270 
ccntrol units. 


[Tisplay systems with PTR capability communicate with a host program so 
that, at selection time of a particular display or printer, the next 
program action (for example, Read Modify, Read Buffer) is known by the 
display system. The display system performs initializaticn sequences 
while the host prepares and issues the next action. This overlap of 
host and control unit activity frees the channel and ccntrol unit 
resources. 


Prepare to Read does nct have to be specified, because the 3274 Model 1D 
will operate in default mode, using the previously defined (local 3270) 
select command. | | 


To use the Prepare to Read ccmmands, the devices attached to a 3274-1D 
must be specified as supporting the Prepare to Read select commands. In 
OS/VS1 or OS/VS2 MVS creratng systems, specifying FEATURE=FTREAL in the 
ICDEVICE macro sets an indicator in the Unit Control Block (UCB). In 
[CS/VSE, a value specified cn the MODE operand sets an indicator in the 
PUE. If these indicators are on, BTAM constructs channel frogranms 
containing the PTR select ccmmands. If the indicator is off, they use 
the local 3270 select command in the channel programs. The result is 
that ETAM applicaticn frograms do not require modification to use the 
PTR select commands. For more information on the Prepare tc Read select 
commands, refer to OS/VS BIAM, GC27-6980, or Basic Telecommunicaticns 
Access Method Extended Suprpert (BITAM-ES) Programming, SC38-0293. 


OP am com> cu pee ee —" eo ce ew a oe EP A: ee ageEP ame amEe cee —_ ee CRD Clee RET CEE cap me oe eae oe > nee GED ane ee ee 
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Note: PTR is supported only on OS/VS1 and OS/VS2 (MVS) ETAM and ETAM-ES. 


The following examples show how an application program using BTAM macro 
instructions can be used to ccencatenate and standardize a data stream. 


Example 1: The normal Read Modified message from a remote ESC 3270 
(2271, 3275, 3274-1C, 3274-51C, 3276) on a nonswitched or switched 
network backup line affrears as follows: 
Sa oe oS ae ee ee ee ee ee ee ee 
{INDEX|STXJCUA DVCJAICICA1 CA2|SEA{A1 A2|TEXT|ETE 
[nS Le LS a Le ee! eS Le en Aree 
ERNIE 
Header for First Block Only 

acai, (RSG GRIER SGURARC: Seas SIAR [rea agra ae came amtaacaal anes | 
For Structured J INCEX|CLE|{CUA|[DVC|STX|AIC| Structured Field (s) [ETB 
Fields: | I | | | | | | 

aa a A a Sans SRA! Aneel rtm vee a ee Riera eaten eee eee RE ene es! | 


The application program can concatenate the klocks (which are generally 
256 bytes or less) in a particular data stream, and strip the index, 
STX, ETX and ETB characters. Control unit address and device address 
can ke converted to a specific terminal name or ID with a table. The 
attention identification may be used to take a standard action (such as 
printing the buffer ccntents) defined for the terminal key that caused 
the interruption. A sukroutine may be used to convert the cursor 
address into screen position (by number, such as 440, or row-colunmn, 
such as 10, 15). The frogram can then pass the combined text (preceded 
with the SBA and address characters) to a screen management routine. 


Fer a 3274-1C or a 3274-51C control unit with the capakility of 
interpreting the structured fields, the inbound write structured field 
would be as below. | 


i l l [Xx"88"| | ETX | 


Cr a oe et, ee ee EP ee ay Py pa eg ee eee ne a eye ope ge ey a ee ee ea ey 
jindex|DLE|STX]|CUA|DVC{AID Ree ME CE Rong tomers Field|ETB or] 
[ee Lee eRe! Leena e Eee ee ane (See ERA er Rene MEN E ar seeiint ere meee are eee eo Ee ee ee eR eS Sea | 


Example 2: A message frcm a local 3272, 3274-1E, and 3274-10 appears as 
follows: 


i CO ee a ee eS ee ee a Me a os Petree OR ae ee 
{ AID | CAT CA2 | SEA |f{| At A2 | TEXT {f 
| ae a a gael aN a ea a ce ies ce poi a 


The application program should know where the data came from so it can 
send data to the source. You can check the relative line number in the 
LECE for the device address. The attention identification and cursor 
address information may be used as described in Example 1, and the text 
then sent to the screen management routine. 


For an inbound data stream from a 3274-1D control unit with the 
structured field capability, the data stream would he: 


Ge a ee het ere Ee oe ee ee ae 
{| AID | Structured Field i 
i x'8st | | 
a is se ce ed 
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Ele 3: A 3275 with the [ial feature sends a message that appears as 
fe) 


Rye eR | Ee ete Roe. Me as pe we ge ey eo ag gee wD ee 
{| STX | AID {| CA1 CA2 | SEA | A1 A2 | TEXT {| ETB [ ... | 
LL. SL... LL... LL. Le 1] canal 


As in Example 1, the application program can concatenate the blocks, 
strip the STX and ETE cr ETX characters, use the AID and cursor address 
data to provide meaningful information, and supply a complete data 
stream to the screen management routine. 


A program using BTAM macro instructions should include error recovery 
Frocedures to prevent unnecessary system or program failure. The 
program should be able to recognize, record, analyze, and correct error 
ccnditions and isolate a defective terminal, line, or control unit after 
a specific number cf retries. Human intervention should be avoided by 
including error recovery procedures in the creation of the frogran. 


— a am aw ane —_— «me om —_ caw ae ee a <a a <9) ee aD ete ee qe oe 


THE ADVANTAGES OF A TERMINAL CONTROL PROGRAM 


A terminal control program may be part of your BTAM application program 
Or it may serve a number of applications. The terminal control program 
issues the BTAM macro instructions that initiate input and output. 
Usually it handles the error recovery you have specified. Ey separating 
this program from the frocessing application Or applications, you allow 
future expansion of individual modules in your teleprocessing 
Programming system without having to change all of them. A terminal 
control program can: 


8 Free the applicaticn program from the details of Ivo, including 
error recovery. The terminal control Erogram can be invoked by an 
instructicn such as GET or PUT. 


e Provide some buffering for the calling frogram. The terminal 
control program might collect all 256-bkyte kLlocks tc ke read from a 
3270 terminal in its input area, then return with the address of the 
entire message. 


@ Simplify input for the ,-rocessing program. For example, the AID 
byte in the data stream from entry of data might not matter to the 
Frocessing program; the terminal contrci frogram can strip the AID 
tyte or bypass it. 


@ Insert certain data stream characters. The terminal ccntrol program 
might contain some or all of the mapping functions suggested in the 
section "Screen Management" or only the I/O macro instructions and 
error recovery, and interface directly with a mapping module. 


THE ACLVANTAGES OF A MASTER TERMINAL PROGRAM 


A master terminal program allows changes (in configuration, for example) 
in a teleprocessing application while the system is in operation. It 
provides a central control that allows the teleprocessing application or 
system to react flexikly to variables such as time of day, user or 
system priority, and system operator or remote supervisor messages. A 
master terminal program can usually be invoked (perhaps by the terminal 
control module) from a message by the console operator or from a local 
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ox remote 3277, 3278, 3279, or a remote 3276 designated as a master 
terminal. 


The master terminal can communicate exclusively with the master terminal 
program or serve as a work terminal and be used as a master terminal 
when reguired. Access to the master terminal program may be available 
to any operator at a terminal designated as a master terminal, to a 
Supervisor using his identification card at any of a number of terminals 
equipped with a card reader, to any terminal operator who entered a 
password authorizing use of the master terminal program, or to an 
operator at the system console. 


Here are some uses for a master terminal program: 


e A common use would te to change the configuration of a 
teleprocessing netwecrk; add or remove cne or more terminals to a 
line. A supervisor at a master terminal in a Denver office could 
send a message to the central office in Kansas City to remove a 
temporarily inactive terminal from a line; the master terminal 
Frogram would then (perhaps using the BIAM CHGNTRY macro 
instruction) set the skip bit for that device in the afrropriate 
terminal list. Time would not be wasted polling that terminal. 


e Cne or more application programs that depend on input and output 
from a system conscle or master terminal could use the master 
terminal program aS a ccmmon interface to the master terminal or 
system console operator. 


e Cn receipt of a master terminal message that the telefrocessing 
System will be switched from one operating system to another, the 
master terminal program could arrange an orderly collection of 
outstanding messages pricr to system shutdown, then start up the 
teleprocessing system again after the new operating system is 
running. 


e If it is desirable to switch disk files at a particular time for a 
given data entry application, a supervisor at a master terminal 
could request the switch and the master terminal program could send 
a request message to the system operator. 


e A master terminal program could broadcast messages to all or 
designated terminals in a system. For example, operatcrs could be 
notified of temporary system shutdown. A Lank might use such a 
broadcast message to send branches of affiliates the serial numbers 
of stolen $100 bills. 


@ A master terminal frogram could maintain the time of day and assure 
that no terminals were polled in time zones that were net yet at 
work. 


TECHNIQUES FOR KEEPING TRACK OF CEVICE STATUS 


There are several reascns why you may want to maintain tables in your 
program with entries fcr each control unit or terminal. These tables 
can be used to store lcgical or symbolic names for use in messages {you 
May want to refer to a farticular terminal in a message as MIAMI rather 
than by its device address number), toe record the activity of each 
device, or to store other information such as dial digits used when 
calling a nonswitched device through a switched network backup facility 
(for example, using the IBM 3872 Modem). 
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The tables in Figure 4-1 may be used to: 


& Associate each control unit or terminal with a name based on its 
geographic locaticn or werk station numker. 


8 Keep track of the number of transactions (inquiries or entries, for 
example) from a terminal either for billing purposes or to see how 
much the terminal is being used. 


e Keep track of various kinds of errors. 
e Keep a priority assignment number when the network is heavily used. 


e Keep the phone numker to be dialed when using switched network 
backup to a contrecl unit. 


Cne way to associate a table with line activity is to kuild your own 
extension to the DECB. Figure 4-2 suggests some of the uses for such a 
DECB extension. 


TRANPTR is an area that stores a pointer to a translation table used 
after an input operaticn. Another byte, PREVOP, stores information on 
what I/O operation tock place prior to the cne the DECB is presently 
associated with; this could te useful in determining error recovery 
actions. Another use would be to store the return address associated 
with an I/O operation when cne Read or Write macro instruction and DECB 
is kranched to from mcre than one place in a program. Here is one DOS, 
DCSy/VS coding technigue for saving a return address with a DECB 
extension: 


BAL R11,WRITT 


WRITT WRITE (R6),T1,C0TFBI1,AREA1,200,,3,MF=E 


B TWAIT 
TWAIT EQU * 
ST R11,RETURN 
TWAIT (R6) ,TERMTST,FCBLIST=LIST 
L R11,RETURN 
BR R11 


RETURN, shown in Figure 4-2, is a three-byte area in the LEFCB extension. 


. Symbolic Future 
Symbolic Number of name use 
name transactions Number of Total 
Contro] unit | Switched backup Terminal address interventions transactions 
address in hex dial digits in hex required 


this week 
MIAMI 
ATLAN 6259 40C1 WKST2 


A contro] unit table A terminal table 


Figure 4-1. Table of Centrcl Unit and Terminal Informaticn 
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User's DECB TRANPTR 
Extension 
PREVOP RETURN 


Figure 4-2. Example cf a User-Built DEFCEB Extension 


RELIAPILITY AND ERROR RECOVERY 


On ene a ee ee ES eee ES see a eee a cami tte TN. age ED emcee OO ee ee eee te eee nee eee oe 


REMOTE LEASED LINE EVENT COMPLETION ANALYSTS 


Cn completion of a 3270 IyC operation, the terminal control frogram 
should analyze the circumstances of the completion and decide what 
action to take. This secticn applies to any terminal control program 
that uses RBTAM. 


The BSC 3270 remote leased line completion analysis is organized in six 
parts. Four of the parts are the flowcharts in Figures 4-3 through 4-6, 
which are a logicai sequence for analyzing completion informaticn after 
a read or write ofperaticn. The flowcharts refer to the Read action 
descriptions or Write action descriptions which follow the Read or Write 
flowcharts. 


The action descriptions are in the following format: 
e The ETAM operaticns to Which the acticn afplies 
® An explanation of the causes of the completion conditicn 
e The advised actions and an explanation, where appropriate 


Certain completion conditions indicate that a control unit sense/status 
message has been received. These messages are generated by the remote 
BSC 3270 in a variety of circumstances to inform the computer of changes 
in the status of 3270 devices. Examples of such changes are the : 
completion of a mechanical frint operation or the receirft Ey the ccntrol 
unit of an invalid command. For further information on the sensSe/status 


Information Display System, Compcnent Description. Where completicn 
conditions exist, the action description contains the advised procedure 
for processing the receipt cf the message as input. However, the 
description of senseystatus analysis should ke consulted tc interpret 
the information in the message and the acticns that follow. The 3270 
sensey/status message must be processed to maintain the availability of 


the remote BSC 3270 devices. 
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DECB Fields 


See This 
Read Action _ 
Description 


. Offset 0 Offset 24 Offset 16 Offset 28 Offset 8 


Oe <> | | oe 


Figure 4-3. DOS BTAM, DOS/VS BTAM, and DOS/VSE BTAM-EFS, Remote 
Nonswitched Line Read Completion Analysis 


1€0 


DECB Fields See This 
Read Acti 
Completion Code Flag Byte Sense Byte TP Code Deseripiion 
Offset 0 Offset 24 Offset 16 Offset 28 


Cp Oe | | 


Figure 4-4. OS BTAM and OS/VS BTAM, Remote Nonswitched Line Read 
Completion Analysis 


Action Description Cne 


Cperations: Fcllows completion of a Read Initial (TI) or Read 
inue (TT). 


Explanation: A text block has been received without hardware or line 
error. The input message may take one of several formats. The format 
generally appears as fcllows: 


a ee on aaa Ra aa a a 1 
{ AUTCEFOLL | [ | { | i {| ETB | 
{ INDEX |} STX | CU { DVC | AID | CURSOR | FIELD LATA | i 
| BYTE | | ATUR | ADDR | | ADDRESS | | ETX | 
a Bt ee ern ae te 


101 


If an operator has initiated the message other than with the Test 
Request key, the first Llock from a device has the above format. The 
maximum block length is 256 characters from Auto Poll index byte through 
ETX or ETB. The block could be less than 256 even if there are | 
subsequent blocks. | 


The following variations to the above format are also possikle: 

@ If Auto Poll is net used or if the message is not from the first 
device to respond to a general poll, STX or DLE STX is the first 
character in the input area. 


e If the CLEAR key or a Program Attention key was pressed, the ETX is 
the only character follcwing the AID byte. 


6 If there are no modified fields, the ETX is the only character 
following the curscr address. 


® If the input block is not the last from the device, an ETB 
terminates the block. ETX terminates the last or cnly block. 


SS SSS ee ne 
| STX | FIELD DATA [{ ETE | or { CLE STX | FIELD LATA | ETB | 
| | | ETX | | [ | ETX jf 
ey A ae AME LANE Re eT LAE MEE REN oe eee ee eee en, Lee 


If the input block is not the first from the device, it has the above 
format. STX or DLE STX is the first character in the input area and 
there is no 3270 header infcrmation. 


; aaa) Ca eee eee Sarna Sonera aioe TE | 
| AUTOPOLL | | | | | 
{ INDEX 1 SOH | 2 ¢ / | STX | TEXT | ETX | 
| EYTE i [ | | | | 


Ce a a hh ee he ee 


The above format could he received if the operator pressed the Test 
Request key on the 3277 or System Request key on the 3278 or 3279 and 
the Binary Synchronous test facility is not included in the FTAM 
support. 


IGS marinate eae aaa Sa aa aaa Canam: 
1 STX | ETX | Or | CLE STX {| ETX | 
nee! Sano! Na as 


The above null message format may be received as the last tElock under 
unusual circumstances. 


Ee 
{ sOT | 
aa 


BTAM passes the EOT character to the user in the input area as a normal 
completion. Bits are set in the DECB to indicate that an EOT has keen 
received (DOS, DOS/VS, and LOS/VSE BTAM-ES). 


Acticn: 


° Issue READ Continue (TT) until EOT is received if multiple messages 
from a control unit on general poll are acceptable. 
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e Issue READ Interrupt (TRV) if multiple screens from any additicnal 
devices pending on the cluster are not desired. 


General polling is being performed and all tElocks associated with the 
first message have been read. All blocks of a screen should be read and 
concatenated before precessing. To do this, move the STX flus one 
location of succeeding blocks to the ETB location of preceding blocks. 
Receipt of a null block can ke processed in the same way. If a Test 
Request message is received in this manner, the Binary Synchronous test 
facility should be included. If this is not possikle, the message may 
be processed as a CLEAR key depression. 


If CS or OS/VS BTAY is used and an EOT is received, the response depends 
on the application. See Read Action Description Three. 


Read Action Descripticn Two 


<a our —_ mee cae ome eee CREEP es cone 


— a se ee oe ae ape ae cee an 


received from the remote control unit. 


a a ee a a ee nen oe ee 
| AUTCFPOLL | | | | | | 
{ INDEX | SOH &% R | STX | CU | DYC | SYS 1 | SYS z {| ETX {| 
| BYTE { i | ADDR | ATCR | | | [ 
a ed 


The Auto Poll index is not present if the Auto Poll feature is not used 
cr if the message is nct the first received in response to a general 
poll. 


In order to maintain the availability of the remote 3270 devices, the 
sense/status message must Le analyzed and acted upon. For guidance in 
processing this message, see the section "Sense/Status Analysis." 


7 ae oe ae ee ED eens ete cae cree ae ae oe OO eee a a — ae, qn ane me 


ETAM Operation: Follows completion of a Read Continue (TT). 


Explanation: An EOT was received in response to the previous Read 


Continue (TT) for a text blcck ending in ETX. 


Action: The action taken depends on the line control progran. 

e A held line system holds the communications line open after receipt 
of a message in anticipation of a respcnse to the device. For this 
type of system the line is left inactive until a respecnse is 
created. At this time a Write Initial (TI) is issued to select the 
device and send the response, — 


e A non-held line system dces not hold the line open after receipt of 
a message. In this type of system the line control prcgram might 
check and issue a Write Initial if output is available. If there is 
no output for the line, polling might Le initiated with the Read 
Initial (TI) macrce instruction. 


In most systems where message throughput is a primary ckijective, lines 
should not be held. 
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ee a ae eee ET en ewes eae one eam oo a EP oe ae aoe a aes ee A ame ae come 


ETAM Operation: Follows completion of a Read Initial (TI) or Read 


— qP ae ee Cal = ce Gai an eo qe a 


Ccontinue (TT). 


Explanation: A text blcck has been received that terminates with an ENQ 
Character. 


Coen ga Te pt ee ee ae i ee oe ee ee ee 
{| STX {| TEXT | ENC | Or | DLE | TEXT | ENQ | 
| l | i | STX | | ; 
nn a Nec lc el 


This message format indicates that the 3270 control unit has detected an 
internal parity check cr a cursor check during transmission. A 
Character with invalid farity is transmitted as a SUB character (EEFCIDIC 
'3F" or ASCII '1A') and the ending ETX or ETB is replaced with the ENQ 
character. In additicn, a data check senseystatus condition is recorded 
at the 3270 control unit. 


for the sending device to retrieve the senseystatus message and reset 
the status condition at the control unit. Use Action Lescription Twe 
after receipt of the sense/status message. 


Read Action Description Five 


> ae eae wa —_ Re CEP ate ene <EED com aoe 


Explanation: A timeout has cccurred. No respcnse to the previous 
polling sequence has keen received in the time allowed by the 
transmission control unit. Eossible causes are: 


@ The 3270 control unit is unable to respcnd, perhaps due to lack of 
Fower, a malfuncticn, or the keylock has not been unlocked. The 
3274 or 3276 ccntrcl unit might be busy executing a local | 
diagnostic. | 


e Conditions on the ccmmunications line prevent transmission. 
e A modem is not functioning. 


e The transmitted polling sequence is not valid for any control unit 
on the communicaticns line. 


ETAM will have retried the cperation; reissuing the macro instruction 
kegins a new sequence. 


After retrying the polling cferation, if the condition persists: Take 
the control unit or terminal out of service and off the polling list. 
This can be done either under program control or in response to operator 
intervention through a master terminal (see "Advantages of a Master 
Terminal Program" in this section). Whether the action is automatic or 
in response to a command entered by an operator, you should issue the 
ETAM CHGNTRY macro instructicn. 


The following is an example of using the CHGNTRY macro instruction to 
remove a control unit from a polling list: 


CHGNTRY (R2) ,AUTCWLST, (R3),5,SKIP 
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(R2) is a register with the address of the folling list, (R3) is a 
register with the relative position of the entry to be changed, and 5 is 
the number of characters in a 3270 polling list entry. The example 
specifies the list as an Autc Poll wrap list but should agree with the 
type specified in the [LFTRMLST macro instruction used tc create the 
list. A CHGNTRY macrc instructicn with the ACTIVATE parameter can 
reinstate the control unit when the difficulty has been corrected. 


The fact that the control unit is not available should be recorded for 
use of the terminal ccntrol frogram, and the operator should be notified 
to take manual recovery acticn if the system has not previously informed 
hin. 


Read Initial (TI) should be reissued after forcing the DECE polling 
entry address (OFFSET 21) to another control unit. If there is no other 
control unit on the line, or all on the line are out of service, the 
line should be recorded as cut of service and no further oferations 
initiated until it is placed back in service, ferhaps by a master 
terminal. 


Read Action Descriticn Six 
ETAM Operation: Follows completion of a Read Initial (TI) or Read 
Ccentinue (TT). 


Explanation: A time-out has occurred. No further transmission has heen 
received after a text Elock acknowledgement (ACK-0O or ACK-1), or text 
flow has stopped withcut a froper ending seguence (ETB, ETX, ENG). The 
Eossible causes include those in Read Action Lescription Five, except an 


invalid polling sequence dces not apply. 


Acticn: 


e Issue a Read Repeat (TP) to acknowledge nc transmissicn received and 
to receive the response, if you want more retries than ETAM error 
recovery provides. 


3 If the problem is not corrected issue a Write Reset (TR) to reset 


the line with an ECT. Remove the ccntrcl unit from the polling list 
as in Read Action L[Lescriftion Five. 


— oe ome ae ne ED see ume eee acre or Ce ee ee OE ee — ae mew ane eee ee ee 


——. me ene ae — yp coe ee ne awe eee eee 


Ccntinue (TT). 


Explanation: The transmissicn control unit has detected an erroneous 
parity or BCC check on the received data. 


—— ae ene ame caer ewes ames em ce mses <a een ee SS aoe a 6 ae comer —_ ——— 


ETAM Operation: Following ccmpletion of a Read Initial (TI) or Read 


Ccentinue (TT). 


Explanation: An overrun condition has occurred. The I/C channel has not 
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Read Action Descripticn Nine 


Operation: Follows completion of Read Initial (TI) or Read Continue 


Explanation: A lost data conditicn has occurred. This is usually due to 
receipt of a data stream that exceeds the length specified for the Read 
operation. 


ETAM Operation: Follows a Read Continue (TT). 


Explanation: The positive acknowledgement cf the preceding text block 
was not properly received by the remote control unit, which responded 
With an ENG character. | 


Acticn: Issue a Read Ccntinue (TT) to retry the acknowledgement. If the 


gad Action Descripticn Eleven 
BIAM Operation: Follows a Read Initial (TI). 


Explanation: A negative resfcnse was received from the last active 


— ame ename Ante te WEG ed ee aD eee 


terminal in an open felling list (DFTRMLST AUTOLST), or a RESETPL macro 
instruction terminated folling. 


e If output is available fcr the line, issue a Write Initial (TI) 
macro instruction to send the message. 


e Resume polling at the beginning of the list. 

€ Suspend polling long enough to reduce the impact of processing 
negative folling responses. 

Read Action Description Twelve 


ETAM Operation: Follows a Read Initial (TI) cr Read Continue (TT). 


ane anne ahee Re ee CED epee NERS eee eee 


—_ cm Ne OE EE SE a GeO cD ee 


macro instruction has nct been issued. 
Action: Issue a TWAIT macre instruction of the forn: 

TWAIT (R1),TERMTST, ECBLIST= (R2) 
where (R1) specifies a register which will contain the address cf the 
CECE posted complete when the TWAIT is satisfied, and (R2) is loaded 
with the address of the DECE with the X"'42" completicn. 


Co not alter the completion code prior to issuing the TWAIT macro 
instruction. 
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Read Action Descripticn Thirteen 
BAM Cperation: Follows Read Initial (TI) cr Read Continue (TT). 


Fxplanation: This is an unrecognized completion and should not occur; 
i 


is probably a software problem. 
3 Take a SNAP dump or EDUME of the system and analyze it. 
e Notify the operatcr cf the ccnditicn. 


@ Issue a Read Initial (TI) to reset the line and resume folling. 


TRANSPARENCY 


For remote 3270 devices, the write transparent macros are used for 
sending Write Structured Field messages. These macros are the 
follcwing: 


r rea Nae Pe DT ee Sy ae! Em Oe a ge gE PO aie ee CR eS ag a Eee eee a caer ar 
| | {| DCS, DCS/YVS 
i | OS/VS | ETAM and DOS/ 
{| Macro {| BIAM { VSE BTAM-ES 
SSS ee eS eS 

{ WRITE Initial Transparent TIX = 

| WRITE Initial Transparent Text -——— TIX 

{ WRITE Initial Transparent Block TIE TIE 

{| WRITE Initial Transparent and Reset TIXR TIXR 

{| WRITE Continue Transparent 7 

{ 

| 

| 


{ 
I 
[ 
i 
[ 
WRITE Continue Transparent Elock | TTE 
[ 
i 
[ 
| 


WRITE Transparent Text Semmens TX 

WRITE Transparent Elock SSS TE 

WRITE Initial Ccnversational Transparent TIVX TIVX 
TTVX TXV 


WRITE Continue Cconversational Transparent 
Oe ga ea tae Te 


In the following descriptions of write actions, the akove macros would 
replace their counterparts if the text being sent were a structured 
field. 


ETAK Operation: Follows Write Initial (TI), Write Continue (TT), Write 
Conversational (TV), cr Write Initial Conversational (TIV). 


Explanation: Text transfer has completed normally. 


e If the previous cperaticn was Write Initial (TI), issue Write 
Continue (TT) if klocked output is hkeing sent and more Llocks 
remain. Note that the 3270 does not accept conventionally blocked 
output. 


it 


eee es Nee ee a enn | Semen toe anemia ere ee ae RR, 


Issue Write Reset (TR) tc send an EOT which resets the line. If it 


is desirable tc resume polling on the line, issue Read Initial (TI 
which resets the line and begins polling. 


1 


)s 


07 


See This 
Write Action 
Description 


Offset 0 © Offset 24 | Offset 29 __ Offset 16 ' Offset 28 Offset 8 


| _ 
| | Pe 4 


DECB Fields 


<e> (Test for any of ; 
N 08, 04, or 02.) 
Coe > Y 


N 


ae 


Figure 4-5. DOS BTAM, DOS/VS BTAM, and DOS/VSE BTAM-ES, Remote 
| Nonswitched Line Write Completion Analysis 
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DECB Fields See This 
Write Action 
Completion Code Flag Byte Sense Byte TP Code Response Info 
Offset 26 


Description 
Offset 0 Offset 24 | Offset 16 Offset 28 


aS | 


10 


Co 


13 
im 


Figure 4-6. OS BTAM and OS/VS BTAM, Remote Nonswitched Line Write 
Completion Analysis 
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e If the previous operation was Write Initial Conversational (TIV), 
Write Continue Conversational (TTV) or Write Conversational (TV), 
issue Read Continue (TT) to read all blocks and the final EOT. 


ETAM Operation: Follows a Write Initial Conversational (TIV), Write 
Continue Conversational (TTV), Write Conversational (TV), Write Initial 
(TI), or Write Continue (TT). 


Explanation: An EOT has been received in response to a text 
transmission. This response indicates that the device could not perform 
the operation specified by the command code in the text. Examples are a 
kusy or unavailable device, or a check condition. The exact cause has 
been recorded at the ccntrol unit. 


er AN line en ete malar 


entry a list containing the specific polling characters of the contrcl 
unit and device that returned the EOT. You cculd code a specific 
polling list with the [LFTRMLST macro instruction for each terminal in 
the system or code cne [LFTRMLST macro instruction and modify the entry 
prior to issuing the Read Initial (TI) macro instruction. See the 
description of the DFITRMLST format in the appropriate ETAM SRL. 


Write Action DLescripticn Three 


BTAM Cperation: Follows Write Initial (TI), Write Continue (TT), Write 


Initial Conversaticnal (TIV), Write Continue Conversaticnal (TTIV), or 
Write Conversational (TV). 


Explanation: A NAK has been received in response to a text transmission. 
This indicates that the 3270 control unit has detected an ENQ character 
in the transmissicn or that the 3271, 3276 cr 3274 (not 3275) has 
detected an invalid Ecc. A 3275 sends an ECT and indicates an invalid 
PCC in the sense/status message. The cause cculd be a transmission 
error or invalid text. BTAK will have retried the operaticn. 


Action: 


ee a oe ae ee oer 


* If the preceding oferation was Write Initial (TI) or Write Continue 
(TT), issue a Write Initial (TI) to retry the operation. 


e If the preceding opferaticn was Write Initial Conversational (TIV) or 
Write Conversational (TV), issue a Write Initial Ccnversational 
(IIV¥) to retry the cperation. 

6 If the conditicn fermits, take a SNAP dump or PDUMP of the text 


klock and notify the operator of the condition so that the fault can 
ke isolated. 


Ore <a GED ee awe SER? CEES qELe cee cw cone a a ae A a ae _— <2 an om Oe <e 


received. Possible causes include: 


a There is no device on this line for the selection seguence that was 
sent. 
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é A hardware transmission error prevented recognition of the selection 
sequence or the acknowledgement. 


e The 3270 is unavailable due to lack of power or a malfunction. 


BIAM will have retried the creration. 


6 If the previous operation was Write Initial (TI), issue a Write 
Initial (TI) te retry the operation. 


e If the previous operaticn was Write Initial Conversational (TIV), 
issue a Write Initial Ccnversational (TIV) to retry the operation. 
If the conditicn persists, take the device out of service. Record 
the fact that the terminal is out of service for use by the terminal 
control program and notify the operator. See "Advantages of a 
Master Terminal Prcgram™ in this chapter. | 


Write Action Descripticn Five 


BIAM Operation: Follows Write Initial (TI), Write Continue (TT), Write 


Initial Conversational (TIV), Write Continue Conversational (TTV), or 
Write Conversational (TV). 


se come Ee ue ae Gee sa aoe aT ee 


received. Possible causes include: 


e The preceding text was received by the 3270 without valid framing 
Characters (STX/ETX) or (DLE STX/ETX). 


s The 3270 has been unavailable. 


@ A transmission errcr has prevented receirt of the response. 


If the condition persists, take the terminal out of service and proceed 
as in Write Action Descripticn Four. 


Arite Action Description Six 


AK Operation: Follcws Write Initial Conversational (TIV), Write 
ntinue Conversational (TTV), or Write Conversational (TV). 


Explanation: Text ending in ENQ has been received. This indicates that 
the 3270 has detected an internal parity check or a cursor check. A SUB 
Character (EBCLDIC '3F" or ASCII '1A") has been substituted for the error 
Character and the ENQ character is transmitted in place of the ETX/ETB 
and BCC. A status condition has been stored at the 3270's control unit. 


Action: Issue a Read Initial (TI) with a polling list ccntaining the 
specific polling sequence fcr the device transmitting the ENC character. 
This retrieves the 327C sense/status message (see "Sense/Status 


Analysis" in this chapter) and resets the status condition. 


Write Action Descripticn Seven 


BTAN Operation: Follows Write Initial Conversational (TIV). 


Explanation: Text was received in error: 


X'O08* —- data check 
X'04* -—- overrun 
X¥'02* — lost data 


See Read Action Descriptions Seven through Nine. 


Action: Issue a Read Repeat (TP) to send a NAK, which transmits the lost 


a qe a emp er ae 


text again. 


Write Action Description Fight 


Explanation: A WACK was received in response to a text write. This is a 
normal response to a text data stream that contains a copy control 
Character or write control character specifying ‘start printer.' It 
implies that the print cferation has begun and that the printer is now 
busy. 


Action: Issue a Write Initial (TI) to send tec another device on the 


a ee Ee am aoED eee 


line, or issue a Read Initdaal (TI) to begin polling on the line. 


Operation: Follows Write Initial (TI) or Write Initial 
ersational (TIV). 


3 lo 
<j (rx 


Explanation: An RVI has been received in respcnse to addressing. This 


—_ oe ae que etme ane ae ante one 


response indicates that the 3270 has pending status, other than device 
end or device busy, which must ke retrieved prior to writing to the 
32710 


Acticn: 


a men come eens omen 


a Issue a Write Reset (TR) to reset the line. 


e Then issue a Read Initial (TI) using a polling list witk the 
specific polling seguence for the device. | 


<— aw ae am me ee ee ae a ee cele ND eee I EE eo om. «ae ane ae me ante ew 


Explanation: A WACK has been received in response to addressing. This 
indicates that the addressed device is busy. 


Action: 


a Issue a Write Reset (TR) to terminate the operation. 


e Then check for output tc another device on the line and issue a 
Write Initial (TI) or initiate polling on the line with a Read 
Initial (TI). 


ae aan eu se ce en a Ne a me Ee que SORE. ene ee ce cee co 2 aS Ee ae ome eee 


ETAM Operation: Follows Write Initial (TI), Write Continue (TIT), Write 
Initial Conversational (TIV), Write Continue Conversational (ITV), or 
Write Conversational (TV). 
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Explanation: This is unrecognized completion and should not occur. The 


Frokable cause is a scftware problen. 


Action: 


@ Take a SNAP dump cr PDUMP of the system for analysis. 
6 Notify the operator of the condition. 


@ Issue a Write Reset (TR) to reset the line, then issue a Read 
Initial (TI) to resume polling. | 


Write Action Description Twelve 


BAM Qperation: Follows a Write Initial (TI). 
Explanation: An incorrect alternating acknowledgement was received in 
response to the text transmission. BTAM has verified that the incorrect 
acknowledgement is inccrrect by sending an ENQ to request retransmission 
of the ACK. 


Action: 


® Issue a Write Reset (TR) to reset the line. Then retry the Write 
Initial (TI). | 


® If the problem persists, notify the operator of the ccnditicn. 
Record the control unit cut cf service and proceed as in Read Action 
Description Five. 

Write Action Descripticn Thirteen 

ETAM Operation: Follows a Write Initial (TI). 


EOT has keen received in respense to a Write Initial trying 
84-3 printer attached to a 3275. 


Action: Read the senseystatus message. 


REMOTE DIAL EVENT COMELETICN ANALYSIS 


This section should help you design or ccde the portion of a terminal 
ccntrol program which, upon completion of a 3270 I/O oferaticn, analyzes 
the completion and decides the proper action. 


The description of the 3270 remote dial event completicn analysis is 
Organized in six parts. Four of the parts are flowcharts contained in 
Figures 4-7 through 4-10. These flowcharts are a logical sequence in 
which completion information can be analyzed after a Read or Write 
Cperation. The flowcharts refer to the action descriptions that 
immediately follow the flowcharts. 


The action descriptions are in the following formats: 
® An explanation of the causes of the ccmpletion condition. 


e The advised actions, and comments, where appropriate. 


DECB Fields See This 


__Completion Code Optype Code Flag Byte Sense Byte, Response TP Code Read Action 
Info, or Error Info as : Description 
Offset 0 Offset 5 Offset 24’ Indicated Offset 28 


SY Y : ae 
fl EOT Received 


| | 
| Response Info 


| 
Sy 


6 Good Read~Text 
N | 


Sense/Status Msg. Rec'd. 


| READ TQM | ENQ Received 
N 


Unknown 


<a> | STX ENQ Received 


| STX ENQ Received 


IN 


READ TI, 
TT, or TIC 


| Time out to 


Read ID ENQ 
08 
N 


Text 


ay y Timeout 
° 
Time out - No 
9 


N- Operator Input 


Sense Byte 


DLE EOT Received 


es 
READ TQM * 


Unknown 


Invalid ID or ID NAK Received | 


Figure 4-7. DOS BTAM, DOS/VS BTAM, and DOS/VSE BTAM-ES, Remote 
Dial Read Completion Analysis 


Read Action Descriptic 


g Action Descra cn One 


TR ce au can: me eee qm epee 


indicating it has no mcre text to send and is releasing control of the 
line. 


Action: Normal completion of a read sequence from the 3275 allows you 


ae ae GR Eee ene ome 


1. Issue a Write Disccnnect if no more input or output is desired from 
or to the 3275. 


2. Issue a Read Inquiry or Read Inquiry Mcnitor to await another bid 


from the 3275. The Read Inguiry Monitor does not allcw a 3275 
time-out. It maintains the connecticn with the 3275 for further 
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DECB Fields 


Offset 0 Offset 24 Offset 16 


a 


See This 
Read Action 
Description 


TP Code 
Offset 28 


Figure 4-8. OS BTAM and OS/VS BTAM, Remote Dial Read Completion 
Analysis 


interaction. You might set a timer interval with the Monitor 
version and end the read with RESETPL after the interval, followed 
ky a Write Disconnect, or a Write Inquiry followed Ly a Write 
Continue to prompt the cperator. 


3. Issue a Write Inquiry to bid for the line, if you want to send a 
message to the terminal. 


If an EOT was not received, then a text block has keen successfully 


received from the 3275 in response to a Read Initial, Read Continue, or 
Read Connect instructicn. 
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{he input may have the following format: 


Sn ee a Sg ee ee ge Te pert ee ny 
| | | Cursor i . {| ETE | 
{ STX | AID | Address | FIELD DATA | ETX | 


If the operator initiated the message other than with the Test Request 
key, the first block has the above general format. The maximum Llock 
length is 256 characters even if there are subseguent blocks because the 
3275 does not break an SEA sequence (3 bytes represent a Luffer 
address). 


The following variations in the above format are possikle: 


@ If the Clear key cr a Prcgram Attenticn key was pressed, the ETX is 
the only character follcwing the AID hyte. 


@ If there are no mcdified fields, the ETX is the only character 
follcwing the curscr address. 


e If the block is net the last from the device, an ETB terminates the 
Elock. EX or ETE terminates the last LElock. 


Sa ee ee 
[| STX | FIELD CATA | ETE | 
i i [| ETX | 
 eetOReeen Se meenre ANE ORE UR AER Tena! 


If the input block is not the first block of the transmissicn series, it 
has the above format (no AIL or cursor address). ETX or ETE terminates 
the last block. 


[= Sage i ee ee 1 
| SOH | % | Y | STX |{ TEXT | ETX | 
oy eR! eee! Sn EeE! eenn NMRA ONES Lannea Lenaeem eon 


The above format could be received if the operator pressed the Test 
Request key and the Einary Synchronous Test Facility is not included in 
ETAM. 


aca Rae ecaaara 
{ STX | ETX | 
Meneame tent Wn 4 


The above format could ke received as the last Elock under certain 
unusual circumstances, and can be ignored. 


Action: Issue Read Continue macre instructicns until EOT is received 
from the 3275, ending its ccntrol of the line. The data blocks can then 
ke concatenated and passed to the application modules, as discussed in 


"Remote Leased Line Event Ccmpletion Analysis" in this chapter. 


Read Action Description Two 


Explanation: A text bicck has been successfully received from the 3275 
from a Read Initial, Read Ccntinue, or Read Ccnnect macro instruction. 
The input may have the following format: 


Ge er ee oe ae a Boe ea. Swe ge ee OM ee eg Oe gre eee Pye Re 
| | { Cursor | / ETB | 


{| STX | AID | Address {| FIELD DATA | ETX | 
Oe er PemeeDateae Cnuenternenn 


If the operator initiated the message other than with the Test Request 
key, the first block has the above general format. The maximum ELlock 
length is 256 characters frcm STX to ETX or ETB. The block could be 
fewer than 256 characters even if there are subsequent kLlocks because 
the 3275 does not kEreak an SEA sequence (3 bytes represent a buffer 
address). 


The following variaticns in the above format are possible: 


@ If the Clear key or a Program Attention key was pressed, the ETX is 
the only character follcwing the AID byte. 


e If there are no modified fields, the ETX is the only character 
following the curscr address. 


6 If the block is not the last from the device, an ETE terminates the 
klock. ETX or ETE terminates the last blcck. 


r i cae eases Sas en 


= 
{ STX | FIELD DATA | ETB | 
4 


| | j ETX 


If the input block is nct the first block cf the transmission series, it 
has the above format (no AIL or cursor address). ETX or ETE terminates 
the last block. 


Ce ee es ee ae ee GO A eS eee oe 
{| SCH | % {| / | STX | TEXT | ETX | 
Vie ee oa eh eee ee ad 


The above format cculd ke received if the cferator pressed the TEST 
REQUEST key and the Binary Synchronous Test Facility is not included in 
ETAR. 


| ere ma ~T 
| STX | ETX | 
ed 


The above format could te received as the last block under certain 
unusual circumstances, and can he ignored. 


Action: Issue Read Continue macro instructions until EOT is received 
from the 3275, ending its control of the line. The data Elocks can then 
ke concatenated and passed to the applicaticn modules, as discussed in 


"Remote Leased Line Event Completion Analysis" in this chapter. 


Read Action Descripticn Three 


Explanation: A 3275 sense/status message has been received (see 
"SenseyStatus Analysis" in this chapter), indicating either a "kusy" 
condition, a return tc "ready" from "ncot-ready" status, or a hardware 


error condition at the terminal. 


Action: Issue a Read Ccntinue macro instructicn to receive EOT from the 
3275 and allow it to relinguish control of the line. Analyze the two 
senseystatus bytes as cutlined in "SenseyStatus Analysis" in this 


Chapter. 


The message has the format: 


Se ee 
{ i d { {| SENSE/STATUS | | 
{| SOH | &% | R | STX | BYTES { ETX | 
th. LL. Lee ee 


== oe a eae p> <n ae qe oe a> Ee ce ee <a Ean ee ee aw ae ae 


on me ee a OP ae au ane ome 


Inguiry Monitor macro instruction, indicating the operator wishes to 
send a message. 


Action: Issue a Read Continue to receive the first text Llock. 


qe «ee ane ame ao ane 


Read Action Descripticn Five 


Explanation: A completion ccndition unknown to the 3275 Dial support has 


occurred. This is prckably caused by a programming error such as 
issuing an invalid macro instruction sequence. 


ae a > ae —~ cn ane Ee a CD GSES antar ere SOT. come —m oe ae eo —_ «= 
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(STX-ENQ received) or a malfunction other than a parity error, and has 

aborted its current transmission. This indicates that the 3275 has an 

error sense/status message fending, which you must retrieve and analyze 
kefore continuing. 


Foliowing Write Text, the 3275 responds with an EOT instead of an ACK-0O, 
ACK-1, or NAK to indicate that a sense/status message is pending and 
must be cleared before any further operation can continue. 


Luring the connect sequence, the 3275 sent the ID followed by a NAK 
instead of ACK-0 tc indicate that the senseystatus is pending and must 
ke cleared. 


Action: To reset the line, issue a Write Reset for OS. Then issue a 
Read Continue macro instruction to read the sense/status message from 
the 3275. See Read Acticn Lescription Three for the format of a 


sense/status message. 


Read Action Descripticn Seven 


—_ a <> cone cae EE oe eae came eam 


Read Connect macro instruction, the 3275 failed to transmit its ID-ENQ 
sequence (CPU answering cperation) or ID-ACK-0 sequence (CEU called the 
terminal) within the TCU's timeout interval. This is prokatly a 
terminal hardware errcr. 


a A ee Ee ea sore 


followed by another Read Initial or Read Connect, aS apfrofriate. 


Read Action Description Fight 


Explanation: The 3275 has failed to transmit text within the TCU's 
time-out period in response to a Read Initial, Read Connect, or Read 
Continue macro instruction. This can occur due to incorrect operator 
procedures on Read Initial cr Read Connect. You should retry the 
Operation. On Read Continue, it is probably a hardware error and is not 
worth retrying. | 


followed by another Read Initial or Read Connect, as aprropriate. 
Alternately, for Read Initial or Read Connect, you might issue a Read 
Inguiry or Read Inguiry Monitor to await input, or issue a Write Inguiry 
to bid for the line and send a prompting message. 


TCU's timeout interval, following the Read Inquiry. This is a normal 
occurrence, depending cn your usage of Read Inquiry and Write Reset 
instead of Read Inguiry Mcnitor and Write Reset Monitor, which cannot 
timecut. | 


> ae a a om ome 


timeout interval, or use the Monitor form of either macro instrucion to 
Wait indefinitely for cperator action. The Monitor form of the macro 
instruction may cause extended toll costs if the operator is not at the 
display station. 


You may also issue a Write Lisconnect (TD) to disconnect the line. This 
action may be appropriate after some specified interval has elapsed 
following a Read Inquiry Mcnitor Operaticn. 


Read Action Descripticn Ten 


n: The 3275 cperatcr has requested immediate termpinaticn of 
tion by fressing the Disconnect key on the 3275. 


followed by another Initial or connect-type macro instruction to 
establish another connection with the same cr another operator. 


“= com a> a> ee eee ore = ae 


ID-NAK to your Read Initial or Read Connect, indicating either a wrong 
terminal or a hardware error. In either case, further communication is 
not desired. 


Action: If expanded IL verification is in use, BTAM automatically 


disconnects the line. Issue the Read Connect (TC) macro. If expanded 
ID verification is not in use, issue a Write Disconnect (TI) macro. 


—_— a «ee on =e ae eer eee ee ae ne Uw ea ree pe ee ae 7 ae ao am me ae 


Explanation: A completicn ccndition unknown to the 3275 dial support has 
occurred; it is probakly caused by a programming error such as issuing 
an invalid macro instruction sequence. 
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DECB Fields 


Completion Code Flag Byte Sense Byte or Error TP Code Optype Code 
OffsetO Offset 24 Info as Indicated Offset 28 Offset 5 


> 
WRITE TQ = Good | 


ai 
acknowledgement | 


EOT Response - Status/Sense Message Pending 


See This 
Write Action 


Description 


WRITE TI - Good 
<r> Y response to text 
N 


response to text 


Authorized ID 
received 


WRITE TR/TRM = 


WRITE TT = Good | 
ENQ received | 


| WRITE TIC- 
| 


| 3 
DLE - EOT Received (Disconnect Req) 4 
Y Y WRITE Ti F 
‘To ID ENQ 
N | 
WRITE TSC 
WRITE TI 
6 
7 
8 


e 
Co | 3 
'N | Unknown Condition 10 


<u> Y ID NAK Received - Status/Sense Pending 3 
Invalid ID Received rT 
WACK to Initial Operation 
- Keyboard, Printer, ID 
<>. Y Reader Busy 12 
WACK to Data or ENQ-— | 
| N Printer Busy 
13 
Unknown Condition 10 


Figure 4-9. DOS BTAM, DOS/VS BTAM, and DOS/VSE BTAM-ES, Remote 
Dial Write Completion Analysis | 
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DECB Fields 


Completion Code Flag Byte TP Code 
Offset 0 Offset 24 Offset 16 Offset 28 


See This 
Write Action 
Description 


Figure 4-10. OS BTAM and OS/VS BTAM, Remote Dial Write Completion 
Analysis 
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an Ee EE Cm atwer ee 


Fossible, including, in order of importance: the DECE (with any user 
extensions you may have appended); DTFBT fcr the line grouf; any 
terminal-status tables you may have in your program; I70O kuffers; and 
application program areas. These should be dumped to an external device 
for printing and analysis. You should then issue a Write Lisconnect to 
disable the line, follcwed by an Initial or Ccnnect macro instruction to 
prepare for further operaticn. 


ep a> qa care CRED CHEK) SpE cme ane em ie a anne qe EON. aa ee wk came eD ee a «EP tee qu ane a eee 


Explanation: An I/C error has occurred on a read operation. The error 
can te a result of lost data, data check, or data overrun. The text 
received is in errcr. 


Action: Issue a Write Lisconnect (TD) to disconnect the line. This is 


proktably the most likely action Lrecause BTAK has already tried 
unsuccessfully the specified number of times. 


As an alternative, you can issue a Read Repeat (TP) to reattempt to read 
the text from the 3275. 
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Explanation: The 3275 has responded positively to the last write 


eR ane OD ANE ERR. CERAD. eee EP wee 


operation on the line. The respecnse means: 


Write Initial: Text received properly 
Write Continue: Text received properly | 
Write Connect; Prorer terminal ID has keen sent Ly the 3275; 


terminal is now ready fcr data. 
Write Inquiry: Positive response to CEU Lid for the line; 
3275 is ready to receive data. 


OED eR AED MERE cE eNO 
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Explanation: The 3275 has responded ENQ to a Write EOT or Write EOT 


me oman RR ee een, UE aD oR ED ee 


Monitor, indicating that it desires to transmit a message. 


Action: Issue a Read Ccntinue macro instructicn to read the message. 


er <a eee wer aqme ee 
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IL verification seguence. The 3275 is sending the IL for verificaticn 
but indicates that it has a sense/status message pending which you must 
read kefore continuing. 


If the connection process has been ccmpleted and a Write Inquiry 
solicits a NAK from the 3275, then the 3275 is again indicating that it 
has a sense/status message fending. 


fhe third instance that could lead to this condition is a Write Initial 
or Write Continue issued during a Write Text sequence. A response of 
ECT from the 3275 instead of ACK-0 or ACK-1 indicates an outstanding 
sense/status message at the 3275. 


Action: Issue a Write Reset macro instruction to reset the line; then 
issue a Read Continue macro instruction to read the senseystatus message 
from the 3275. You shculd issue another Read Continue after receipt of 
the sense/status to allow the 3275 to transmit EOT and clear its status 


connection. The message has the forn: 
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Ycu should now analyze the two SS bytes, as descrikted under the heading 
"Sense/Status Analysis" and take the appropriate corrective action. 
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Explanation: The remote operator has requested immediate disconnection 
through use of the DISCCNNECT switch on the display, and has prokakly 
already hung up the phcne. 


me ae aT ew ene oo 


1. If the data set has Auto Disconnect and the device was dialed by 
the computer, issue a CONTROL Disable cr a Write Break macro 
instruction on the same DECE. 


Example: [symkrcol] CONTROL DECBNAME,TD,MF=E 


2. If the data set does not have the Auto [Tisconnect Feature, or if 
the data set has Auto Disconnect and the device was not dialed by 
the computer issue a Write Lisconnect macro instructicn against the 
Same DECB. Then issue a Write Initial or Write Connect to call 
another terminal, or a Read Initial or Read Connect to await 
another call. 


Write Action Description Five 


ow <a» ae ane assy ee eye ae 


Write Initial macro instructicns, the 3275 failed to respond to your 
Frogram's transmitted IL sequence within the TCU 3-second timeout 
interval. This is prcekably a terminal hardware error; this particular 
terminal should probably not be called again until checked. 


If the Write Initial has successfully established a connection with the 
3275 (including receirt of the ID sequence), then this ccmpletion 
indicates that the 3275 has failed to respond to the text block 
transmitted as part of the Write Initial. 


Action: 


1. Issue a Write Disconnect macro instructicn on the same LECB to 
disconnect and disable the line. 


Ze Issue another Write Initial or Write Connect macre instruction to 


the same terminal (if immediate retry is desired), or to another 
terminal. 
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ccnnection with the 3275 (including receipt of the ID sequence), the 
3275 has failed to respond tc the text block transmitted as part of the 
Write Initial. | 


<a an aR aD EE 
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Explanation: A text blcck was sent to the 3275 using a Write Continue, 
but the 3275 failed to acknowledge the block within the TCU's 3-second 
timeout interval. 


Action: 

A. Issue a.Write Inquiry macro instruction to ask the 3275 to 
retransmit its last response. The response may have keen garbled or 
a momentary line lcss may have occurred. OS aiid OS/YWS provide an 
area for the response to he read into. There are two ways to 
provide BTAM with pointers to this area: 


1. The ENTRY cperand technique. You provide a parameter list 
pointer with the ENTRY operand of the Write TQ. The parameter 
list contains the fullword address of the respense input area, 
and a fullword constant containing the length of the input area 
(2 is sufficient). For example: 


(symbol) WRITE CLECBNAME,TQ,,,,PARMLIST,MF=E 

PARMLIST DC A (RESPAREA) ADDR CF RESPCNSE INPUT AREA 
DC Ft z' LENGTH OF RESPONSE INFUT AREA 

RESPAREA DS CL2 RESPONSE INPUT AREA 


2. The DECB extension technique. You frovide the address and 
length of the response input area in the Write TQ macro 
instruction itself, which then stores the information in the 
DECB extension. For example: 


(symbol) WRITE CLECBNAME,TQ,, (,RESPAREA) ,(,2) MF=E 


The method you use must agree with the specificaticn of the 
ETMOD macrc instruction DECBEXT parameter. If BIMCD specifies 
DECBEXT=YES, ycu must use the LECE extension technigue; 
Similarly, if you use the DECB extension technique, ETMOD must 
specify DECBEXT=YES. The BIMOL parameter choice may he dictated 
by other terminal types in the system. Conversaticnal reads and 
writes to a 2770 require the DECB extension, and you would then 
have to use the same technigue. 


B. If the Write TC completes successfully, you may send another kLlock 
of data with Write Continue, or end with Write EOT. If Write TQ is 
nct successful, issue a Write Disconnect followed Ly Write Initial 
or Write Connect, as desired. 


Arite Action Lescripticn Eight 


Explanation: The 3275 has failed to respend te the Write Inguiry macro 


a aa <n cate ae GEE alee eee a eee 


instruction; ETAM has retried the number of times specified in the 
DIFBI. Further attempts are protably useless. 


a a a ae ee ee 
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Explanation: You issued a Write ECT orWrite Reset macro instruction to 
relinguish control of the line, and the 3275 has not bid for control 
within 7 seconds for OS, or the number of seconds represented by 3 times 
the number of retries specified in DfFBL in COS and DOS/VS. 


of this type of time-cut, and if a reasonable number is exceeded, 
disconnect the line and reinitialize for another call. 


You could also issue a Read Inquiry Monitor, which will not time out, 
following this first completion of the Write EOT or Write Reset. 


Alternately, you could issue a Write EOT Mcnitor or Write Reset Monitor, 
neither of which will time out, instead of the Write EOT. 


If the Monitor macro instructions are used, be aware of the possibility 
an operator may leave the terminal without requesting disconnection, 
which could result in substantial line toll ccsts. You should perhaps 
set a timer interval when issuing a Monitor operation, and stop the 
operation with a RESETPL macro instruction if the operaticn is not 
ccmplete within the time interval. 


—~ <> a cor oe a Gee ap ae ee eer SET ame OE ee a a ae ae a <a 


Explanation: A completion ccndition unknown to 3275 Dial suffort has 
cccurred, which is probably caused by a programming error such as 
issuing an invalid macro instruction seguence. 


Fossible, including, in order of importance: the DECB (with any user 
extensions you may have apfended); DIFBT for the line grourf; any 
terminal-status tables you may have in your program; I/O Ltuffers; and 
application program areas. These should be dumped to an external device 
for printing and analysis. You should then issue a Write Lisconnect to 
disakle the line, follcwed by an Initial or Connect macro instruction to 
prepare for further operation. 
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Explanation: An ID sequence other than any specified in the DFTRMLST 
mMacrc instruction has keen received from the 3275 during a Write Initial 
or Write Connect operation. 


oe ae a a ae oe 


fcllowed by another Write Initial or Write Connect to enakle the line, 
aS appropriate. 


Note: Because terminal IL lists are not reentrant and reusakle, it may 
be appropriate to do an ID check against a common list at this point. 
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Explanation: The 3275 has responded with WACK to your attempt to 
establish communicaticns with a Write Initial or Write Connect. This 
indicates a "busy" ccndition invclving the keyboard, operator ILD card 
reader, or printer. 
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Acticn: Issue a Write Lisccnnect to disconnect and disable the line, 


followed by another Write Initial or Write Connect to establish 
ccnnection with another terminal. 


Write ae DTescripticn Thirteen 


mp a> a a cee ee ED EE Ee 


this condition occurs only if you had the Start-Print Lrit cn in the _ 
Write Control character. WACK indicates that the text has been _— 
successfully received and that printing has started. Ne further text 
transfers are possible until the printing is finished. } 


control of the line erg monitor for completion. When this WRITE TRM 
completes, issue a Read Continue to receive the sense/status message 
from the 3275 indicating device end (senseystatus Lytes = X'C240"). On 
receipt of this message and its following EOT, you may initiate any new 
transmissions you desire, or monitor the line for terminal activity. 


Write Action Descripticn Fourteen 


Explanation: The acknowledgment received from the 3275 in response to a 
write command is not the expected alternating acknowledgement (ACK-0O or 
ACK-1). A message. may me lest. 


its last response (for example, ACK-Q, ACK-1, or NAK). 


If you are unable to reconstruct the message cr resolve the sequence of 
acknowledgements, issue a Write Lisconnect (TL) to disccnnect the line. 
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Grite is in error. The indicated cause of the error is lost satel data 
check or overrun. | ‘ 


Action: Issue a Read Repeat (TP) to reattempt to read the text. BTAM 


has already tried a specified number of times so if the condition. 
ccntinues, issue a Write Disconnect to disconnect the line. 


LOCAL EVENT COMPLETION AWALYSIS 


The information in this section should helpf you design or ccde the 
portion of a terminal ccntrcl program which, upon completion of 3270 I/0 
operation, analyzes the circumstances of the completion and decides the 
proper action. A local 3270 includes a 3272, a 3274-1B, or a 3274-10 
ccntrol unit. | | 


The descripticn of the 3270 local event completion analysis is organized 
in six parts. Four of the farts are flowcharts contained in Figures 
4-11 through 4-14. These flcwcharts are a logical sequence in which 
completion information can ke analyzed after a Read or Write operaticn. 
The Erase/Write Alternate ccmmand performs the same functicn as the © 
ERASE/WRITE command and causes a device with alternate kuffer capability © 
to enter alternate buffer mcde. On local 3274-1D devices, the Prepare 
to Read command enables the display system to communicate with the hest 
program so that, at selecticn time of a particular display or printer, 
the display system knows the next program action. The Write Structured 
Field (TSF) command causes a 3274 to enter write Structured Field mode. 
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° DECB Fields ; See This 


Read Action 
Completion Code Beica 
Offset 0 Offset 16 


| 


RESETPL 


N 
N 
N 
Cu> READ TI After RFT Process 
N 
N 


RFT on READ T! 


i | 
Y 5 


Y <> Y Operation Check 7 


N 


| N 
| <a> Control Check 8 
N 
| Co Y Data Check 9 
| ; 
DC, Unit Specif 
| Coo > nit Specify 10 
| N 
Y Bus Out 
| <a> 7 
| N 
Y Intervention Re 
| 12 
CR 
| <a> . 13 


Figure 4-11. DOS BTAM, DOS/VS BTAM, and DOS/VSE BTAM-ES, Local Read 
Completion Analysis 
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DECB Fields | 


Offset 0 Offset 24 Offset 29 Offset 16 


“ | 


Y 


See This 
Read Action 
Description 


N | Loop 


OLTEP 


Intercept 


Y OC 


N 1/O Error 


Buffer Doubtful 


N (/O Error 


Figure 4-12. OS BTAM, OS/VS BTAM, and DOS/VSE BTAM-ES, Local Read 
Completion Analysis 


Figures 4-11 through 4-14 refer to the action descripticns that 
immediately follow. The acticn descripticns are in the following 
fcrmat: 

e An explanation of the causes of the completion conditicn 


e The advised actions and comments, where appropriate 


Read Action Descripticn One 


Explanation: The Read operation has been completed successfully. The 
input message may take cne of several formats. 

, as meee TL ap eee On ee ee ee te aie, Behe ot ee ee 7 
{AIC {| CURSOR ADDRESS | FIELU DATA {| or {| AID | Structured Field(s) | 
| | l | | x'88" | | | 
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If the operator has initiated the transacticn other than with the TEST 
RECUEST key, the message has the above general format. The following 
variations are also fossible: : 


e If the CLEAR key cr Program Attenticn key was pressed, the AID byte 
is the only character received. 


e If there are no mcdified fields and the oferation was a Read 
Yodified, only the AID Eyte and cursor address are received. 
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Action: The acticn taken defends on the line ccntrol program. You may: 

« Check for the availability of output and, if present, write toa 
terminal with a Write Initial (TI), Write Erase (TS), Erase/Write 
Alternate (TSA), or Write Structured Field (TSF) or issue a Write 
Unprotected Erase (TUS) to the same format again. Write Unprotected 
Erase does not transmit text. 


If no output is available, issue a Read Initial (TI) so that the 
next operator acticn is recognized. 


Read Action Descrirticn Two 


: The previcusly initiated Read Initial (TI) was terminated 
Sage receift, by a RESETPL macro instruction. 


Action: The appropriate action depends on the line control frogram. You 


ae aap ae oe eee 


8 If there is output for the control unit, issue a Write Initial (TI), 
Write Erase (TS) or Erase/Write Alternate (TSA) to send the message. 


e Resume the Read Initial (TI). 


e Issue a CLOSE macro instruction to terminate operations on the 
control unit. 
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Explanation: A REQUEST-FOR-TEST message has been received in response to 


a Read Initial (TI), and a TWAIT macro instruction has not Leen issued. 


Acticn: Issue a TWAIT macro in the form: 


a le em ce ee oe 


TWAIT (R1),TERMTST, (R2) 


(R1) is a register that contains the address of the DECE, which is 
posted as complete on the satisfaction of the TWAIT; (R2) is loaded with 
the address of the LTECE, which is posted with the xX'42' completion ccde. 
The completion code shculd nct be altered prior to the issuance of the 
TWAIT. 


If the online terminal test facility is not availakle, the 
RECUEST-FOR-TEST message might be processed the same as a CLEAR key 
depression. 


Read Action Descripticn Four 


a i ee aa ae come 


Or Erase/Write Alternate (TSA). This could require maintaining an image 
of the device buffer during frocessing because the buffer may te the 
Cumulative result of multiple I/O transactions. 


129 


Read Action Description Five 
Explanation: ETAM has detected a cancel ccndition. 


Action: Take a PDUMP or SWAP Aap or the systen. Issue an operator 


a << <a se «nee ane 


awareness message and terminate the system after Eocene 
checkpoint/restart information, if required. 
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cccur The pe orabie cause 1S a program error. 


Action: 


e Take a PDUMP or SNAF dump of the system for analysis. 
e Notify the operatcr of the conditicn. 


e Issue a Read Initial (TI) to resume input. 


Read Action Description Sever 


Explanation: The 3272, 3274 Model 1B, cr 3274 Model 1D has detected an 
operation check. Possible causes are: 


e The data stream transmitted as the result of a Read Modified fron 
Position (TMP) or Read Euffer from Positicn (TBP) contains an 
lllegal buffer address. 


e The data streams ccntain a Write Ccntrcl Character that specified 
Start print. 


Action: 


e Take a SNAP dump or EDUME of the offending data streams for 
analysis. 


e Issue a peansactren cance tied message to the terminal. 


Inform the system cferatcr of the cccurrence. 


Read Action Descripticn Eight 


Explanation: The 3272, 3274 Model 1B, or 3274 Model 1D has detected a 


an ——_ RP a Ee ee EP ae aS eee 


control check conditicn. The addressed device failed to perform an 
Ccreration or respond tc the control unit within a pericd of time 
determined by the control unit. 

Acticn: | 

® Retry the failing cperation the specified number of times. 

e Notify the operator of the occurrence, | 


@ Mark the terminal as out of service. 
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a Remove the terminal from the line group by issuing a CHGNTRY macro 
instructicn of the form: 


(for OS and OS/VS 
CHGNTRY (R1),AITLST, (R2),,SKIP 


(for DOS and DOS/VS) 
CHGNTRY (R1),ATTLSI, (R2),SKIFE 


R1 is loaded with the address of the DIF/ICB and R2 is loaded with 
the relative line number of the terminal. 


e After repairs have Leen made, the terminal can be flaced back in 
service in resronse to an operator command through the use of a 
CHGNTRY macro instructicn with the activate parameter. 

Read Action Descrigpticn Nine 


Explanation: The 3272, 3274 Model 1B, cr 3274 Model 1D has detected a 


ew ae eee ae ee ae 
om ae ae owe ew oe 
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e The entire device Luffer must be reconstructed with an Erase Write 
(TS) or Erase Write Alternate (TSA) ccommand. 


6 If desired, the failing operation may then ke retried. This may 
require maintaining an image of the current buffer content which may 
consist of several I/C operations. 


e It may be preferable to issue a Erase Write (TS) or Erase/Write 
Alternate (TSA) ccmmand indicating that the transacticn has akorted. 


Proceed as. in Read Acticn Description Eight. 


—_—- << a ee ce ae E> ee we me 


bus-out check (inccrrect parity on a command cr data received from the 
channel). 
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crerational). 
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Action: 


@ Notify the system cferatcr of the conditicn. 


e Take the terminal cut of service. See Read Action Description Eight 
for an example of the CHGNTRY macro instruction. 


Reissue the failing macro instruction if it was Read Initial (TI). 


Read Action Descripticn Thirteen 


OP A <P aap sae ane 


Explanation: The Write cperation has been frosted complete without error. 
For a DOS, DOS/SVS, or LOS/VSE printer, this only signals that the print 
Creration has begun. fErint errors which occur after channel end are 
posted through a return code '30' on the subsequent Read or Write 
cperation. 


terminals on this control unit and send a Write Erase or Erase/wWrite 
Alternate (TSA) or Write Initial (TI). Issue a Read Initial (TI). 


Note: Channel end posting fcr printers releases the DECB after the print 


cycle. Separate DECEs are recommended for frinter operaticns to allow 
the application program to perform I/O operations to other devices while 
print operations are in progress. The separate DECBs avoid extended 
waiting for completion of a frint operation. 


Aa Gwe ere cam atese ame one TR ene <a oC eae TOY aR RE ec cypahe = «aw come ae —- «me om 


—-. A NS ERED CRN RAE a ED ee 
a aa a cme eo 


ar GE ame aap ae ee eee aa enue ame aa eer eee com 6888. ce am —- «er a come << cme EP ome ame 


132 


DECB Fields See This 


Write Acti 
Completion Code Bescaption: 
Offset 0 Offset 16 

o> 

‘ | 
“ ; 

N | 
“ : 


Figure 4-13. DOS BTAM, DOS/VS BTAM, and DOS/VSE BTAM-ES, Local 
Write Completion Analysis 
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DECB Fields 


Completion Code Flag Byte Sense Byte 
Offset 0 Offset 24 Offset 29 Offset 16 


See This 
Write Action 
Description 


La 


Y 


Figure 4-14. OS BTAM and OS/VS BTAM, Local Write Completion 
Analysis 
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Explanation: The 3272, 3274 Model 1B, or 3274 Model 1D has detected an 


operation check. Possikle causes are: 
e The data stream ccntains an invalid buffer address. 
a The data stream ends prior to the ccompleticn of an order sequence. 


Action: Same as Read Action Description Seven. 


— «ae ane com aoe one eo eo ow oe er ae ane ae oe om ~——_ aw a owe oe ae ow oe 


Explanation: The 3272, 3274 Model 1B, cr 3274 Model 1D has detected a 


control check. The device failed to perform an operaticn cr respond to 
the 3272 or 3274 in the time allowed by the control unit. 


ee a ee ae oe ome ee cee aoe see ee anes ame ve ED. ae ea ee aw eee eae —- = <a 


Explanation: The 3272, 3274 Model 1B, or 3274 Model 1D has detected a 


data check. This is a hardware error. 


Action: Same as Read Acticn Lescription Eight. 


—— a, ae am ae A ED CD RE TORY cD eee OUP cen TO ee aren a a an ane AE amy cee wate ee 


Explanation: A printer cr display has detected a data check. This is a 


Write Action Descripticn Eight 


Explanation: The 3272, 3274 Model 1B, or 3274 Model 1D has detected a 
bus-out check (incorrect parity on a command or data received from the 
channel). 


Action: Same as Read Action Lescription Eight. 


Write Action Description Nine 


Explanation: The addressed device is unavailable (fowered cff or not 


Se ee oem ent ame eee cee 


operational). 


Action: Same as Read Action Description Twelve. 


—_ a7 ee aw ow a 
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Explanation: The 3272, 3274 Model 1B, or 3274 Model 1D has detected an 

invalid command. This could be due to an ERASE/WRITE ALTERNATE command 
cr a WRITE STRUCTURED FIELD command's heing sent to a 3272 or 3274-1B, 

or to a PREPARE TO REAL command's being sent to a 3272 or 3274-1E. 


> a a ae ae ae 
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Write Action Descripticn Eleven 


The device buffer is unreliakle kecause of diagnostic 
r completicn of the previous output operaticn. 


@D ee 


Explanation: The inputycutput request was rejected because an error 
occurred following the previous operation or request-fcr-test 
processing. , 


<—— <n ee ene ae ow 


Explanation: A permanent I/C error has occurred. 


Action: Same as Read Acticn Lescription Eight. 


SENSE/SSTATUS ANALYSIS 


Unlike previous terminal systems which told you only that an error had 
occurred, the 3270 Infcrmaticn Display System has a self-diagnosis 
system to inform the central site of error or completicn ccnditions. In 
remote configuraticns this senseystatus infcrmation is communicated in a 
special message format as illustrated in the Read Completicn Analysis 
sections (Read Action [Tescriftion Three for remote dial, Read Action 
Description One for remote leased multipoint). 


Proper analysis and use of the sense/status bytes may improve system 
availability. In many cases, a specific retry operaticn can correct an 
error conditicn and allcw ncrmal system operation to proceed. Also, 
cenditions requiring manual intervention, such as a powered-down display 
or printer, or a printer out of paper, can be quickly identified. 

Froper personnel can te notified to correct the situaticn. Serious 
hardware malfunctions may be identified, lcgged out, and ccmmunicated to 
Froeper maintenance personnel as an aid in diagnoSing and ccrrecting the 
problem. For a defailted description cf the Sense/Status Analysis 


a. <a nm me ee ee A ERS NET MaRS 


Ancther access method that can be used in the telecommunications 
management of the 3270 display system is the Telecommunications Access 
Method (TCAM). MTCAK ccntrols data transfer ketween main storage and 
local or remote display stations. It operates under OS/VS1 and OS/VS2 
and supports the 3270 display system in areas such as device scheduling, 
diagnostic testing, and errcr handling and recording. (See Figures 5-1 
through 5-4.) 


This chapter presents cnly an overview of TCAM support for the 3270; it 
does not give a complete description of TCAM support. The following 
TCAM publications frovide detailed information about TCAM: 


OS/VS ICAM System Programmer's Guide ICAM Level 10, GC30-2051 


OS/VS TCAM Macro Reference Guide TCAM Level 10, GC30-2052 
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SC30-3118 


Advanced Communicaticns Function for TCAM, Prog Prod, Operator's 
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SC30-3136 


ICAM addresses, folls, and manages binary synchronous line ccentrcl (BSC) 
and synchronous data link ccntrol (SDLC) according to the user's 
definition. Read modified is the only TCAM read operaticn fcr the 
remote 3270. | 


DEFINING THE 3270 NETWCRK 


oe ane ae eee cw ew a ee emu cae ae ae cae me —~ oer er eee a ee ae 


The following secticns discuss scme of the TCAM macro instructicns and 
crerands that affect the 327C; for complete information ahcut their use, 
see the TCAM publicaticns cited above. Figure 5-5 indicates which TCAM 
Macros are used to define 3270 stations according to their attachment 
mcde. The switched 3275 is not supported Ly TCAM. 
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Note: The switched 3275 is not supported by any release of TCAM. 


1 The 3278 Model 5 is not supported. 
2 The extended 3270 data stream is supported. 
3 The 3270 printers are not supported by TCAM/TSO. 


Figure 5-1. TCAM Release Support of 3270 Attachment Mcdes 
as 


TCAM10 Direct with TSO 


ACF/TCAM/TSO Version 0 


ACF/TCAM/TSO Version 2 


Figure 5-2. MTCAM Release Support under CS/VS1 and OS/VS2. 


TCAM10 Direct 


i Xx 
: 


Figure 5-3. ICAM Release Support of Applicaticn Program Interface Tyres 
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LU.TO LU.T2 


TCAM10 Direct 


Figure 5-4. TCAM Release Support of Cross-Domain Networking for 3270 
Attachment Modes 


‘Switched lines only. 


Figure 5-5. MTCAM Macrcs Used to Define the 3270 Device Acccrding to 
Attachment Kode 


TERMINAL MACRO INSTRUCTION 


The TERMINAL macro instructicn defines the cluster ccntrol unit and the 
devices attached tc it (for ESC and SNA). It is only required for 3270 
ccntrol units if general polling is specified. 


Figure 5-6 gives the TERMINAL macro operands used to define 327C devices 
acccrding to attachment mode. 


The USS operand is the only distinguishing operand fer LU.TC or 


To specify LU.1T0 code USS=3270 
To specify LU.T2 ccde USS=SCS 
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Non SNA. 
| Locals 


'Non-NCP Local [Lu -TO LUTZ 


hwo 
[axerru | 


OPDATA 
ee LIM! 


——— 
RETRY! 


SCRSIZE 
SECTERM 
SPECOUT 


| TBLKSZ 
TCMSESN 


USS 


UTERM! 


O = optional R = required — = not used 


i 
.?) 
wo 


Note: Not all these operands are valid for every release of TCAM. Consult the 
macro reference guide for your release of TCAM to determine which 
operands can be used. 


1 For switched lines only. 


Figure 5-6. TERMINAL Macro Operands Used tc Define 3270 Devices 
Acccrding to Attachment Mode 
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INVLIST MACRO INSTRUCTICN 


The INVLIST macro instructicn generates the folling list fcr BSC non-NCP 
3270s, the type of read operation for 3270 non-SNA locals, and the IDs 
for SNA switched 3270s. Each INVLIST macre defines the folling 
Characters for all devices cn a ESC non-NCF line. TCAM reguires a 
specific poll entry fcr every 3270 printer and display, whether folled 
cr not. If general polling is desired, an CRIER= sukoperand specifying 
the general poll characters for each BSC cluster control unit must also 
ke included in the INVLIST macro specification. 


IFCREH MACRO INSTRUCTICN 


The IEDRH macro instruction is used for LU.T2 SNA 3270s to set Begin 
Eracket, End Eracket, and Change Direction flag bits in the SNA Request 
Header in outgoing messages. 


GRCUP ANT [CCB MACRO INSTRUCTIONS 


ICAM has the concert of "line groups," sets of lines that have conrmon 
characteristics and that permit operator ccntrcl of a ccllection of 
lines with single commands. 


For non-NCP BSC and non-SNA local staticns, line groups must be defined 
for lines to which 3270 devices are attached with the line grour [CB 
macro instruction. Figure 5-7 indicates which DCB macrce oferands are 
used to define such line groups. 


For NCP ESC and all SNA 327C devices, line grours are defined with the 
GRCUEF macro instructicn. Figure 5-8 indicates which GROUP macro 
cperands are supported for various modes of 3270 attachment. 


The DCB macro is also used to define 3705 controllers operating in NCP 
mcde and SNA local clusters. The principal information sufflied by the 
[CCE macro for these types of resources is the DEINAME of a JCL CD card, 
which defines the subchannel to which the fhysical unit is attached. 

See the TCAM publicaticns for further information on this use of the DCB 
macro. 


CEFINING LOCAL NON-SNA 3270 CLUSTERS 
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Fach non-SNA local 327C control unit is considered to ke a line group 
and therefore requires a DCE macro. Each device attached tc the control 
unit is treated as a "line," since it has its own sukchannel address, 
and therefore requires a unigue RLN= oferand value on the TERMINAL macro 
representing the device. A separate INVLIST macro must ke coded for 
each station on the ccntrol unit. 


Cynamic buffering is not supported for the local non-SNA 3270. 
ECI=(N,N) must be used. 


If ycu are defining a local 3270 that uses the 3278, 3279, 3287, or 
3289, you should ncte that they must be specified as scme cther 3270 
device of the same type (for example, the 3278 display must be specified 
as a 3277 display). 
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Non-SNA 
Locals 


BUFIN 

BUFMAX 
BUFOUT 
BUFSIZE 
CPRI | 
DDNAME 


EXLST 


INTVL 


INVLIST 


MACRF 


a") 
© 


RESERVE 


SCT 


O = optional R = required — = not used 


Note: Not a// these operands are valid for every release of TCAM. Consult the macro 
reference guide for your release of TCAM to determine which operands can be 
used. 


Figure 5-7. CCB Macre Oferands Used to Define 3270 Devices Acccrding 
| to Attachment Kcde 


142 


LU.TO LU.T2 


O = optional R = required — = not used 


Note: Not a// these operands are valid for every release of TCAM. Consult your 
TCAM macro reference guide for your release of TCAM to determine which 
operands can be used. 


Figure 5-8. GROUP Macre Operands Used tc Tefine 3270 Levices According 
to Attachment Mode 


SAMELE RESCURCE DEFINITICNS 


Following are sample definiticns for each type of 3270 display 
attachment supforted Ly TCAM. In each sample are defined a line group, 
line, cluster controller or physical unit, cne device or lcgical unit, 
and an invitation list (if necessary). In real-life ccnfigurations, a 
line group includes several lines, each line has several cluster 
ccntrollers or physical units attached to it, and each cluster 
controller or physical unit has many devices or logical units attached 
CG. Lt; : 7 


Remote LU Type 2 


GRE3274 GROUP EUFOUT=2, BUFMAX=2,MH=SNAEDSMH, PCI=(,N), 
RESEEVE= (30,27) ,OFACING=5, 
TRANS=EBCD,BUFSIZE=2000 


HDX3274 TERMINAL AL RLN=1, 
| GROUP=GRP 3274, 
TERM=LINE, ACTIVE=NC 


HP13274 TERMINAL AL TERM=PUNT, 
| ACTIVE=NO 
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HL13274 


GRE3270 


HDX3270 
HP 13270 


HLC3270 


TERMINAL 


GROUP 


TERMINAL 


TERMINAL 


TERMINAL 


Ncn-NCP Remote BSC 


DCB3274R 


INV3274R 


EE3274CL 


EF3274ST 


ee <P <a am ae ON. cee 


DCB 


INVLIST 


TERMINAL 


TERMINAL 


Non-SNA Local 
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CCE32741L 


INVYAL 


YAL 


INVLIST 


TERMINAL 


AL RLN=1,ACTIVE=(YES,NO) , USS=SCS, . 
TERN=LUNT, TCMSESN=NORMAL, FEATURE= (NOEREAK, NOATTN) , 
GROUP=GRP 3274, SCRSIZE= (24,80, 43 780), - 
CBY=1,LEVEL= (0,255), 

QUEUES=DRT, 

SECTERM=YES, 

LMD=YES 


EUFCUT=2, BUFMAX=2, BUFSIZE=2000, MH=SNAEDSMH, ~ 
PCI=(,N) , TRANS=EBCD 


RLN=1,GROUP=GRP3270, TERM=LINE, ACTIVE=NO 
TERM=PUNT,ACTIVE=NO,FMPROF=0, TSEROF=1 


RLN=1, ACTIVE= (YES,NO) ,USS=3270, TERM=LUNT, 
TCMSESN=NORMAL, FEATURE= (NOBREAK,NOATTRH), 
GROUF=GRP3270,SCRSIZE= (24,80) ,QBY=T, 
QUEUES=DRT,SECTERM=YES,LMD=yes 


CSCRG=TX, MACRF=(G,F) ,CTNAME=DD3274E, EUFSIZE=2C00, 
INVLIST=INV3274R,MH=BSCEDSMH, TRANS=EBCD, 

RESERVE= (30) , INTVL=7, BUFOUT=2, PCI=(,N) ,SCT=EBCD, 
EUFIN=2, BUFMAX=2,CPRI=S 


CRDER= (EP3274CL-4O4O7EFTF2L, EP3274ST+404C4C4C2D) 
EOT=37,AUTO=NO 


CEY=1,TERM=327C, TCB=CCE3274R, RLN=1 


QUEUES=DNT,QBY=T, SECTERM=YES, TERM=327R, 
LEVEL= (0,255) , DCB=CTCE3274R, NTELKSZ=3500, 
TBLKSZ=2000, ADDR=606040402D,RLN=1, 
SCRSIZE= (24,80,43,80) 


DSORG=TX, MACRF=(G,P) ,DDNAME=DL3274L, 
EUFSIZE=1000, MH=BSCELCSMH, TRANS=EECL, EUFMAX=10, 
INVLIST=(INVYAL) ,RESERVE= (30) ,BUFIN=10, BUFOUT=10, 
FCI= (N,N) ,SCT=EECLT,CERI=S 


ORDER= (YAL=+06) 
CUEUES=MRT, QOBY=T, SECTERM=YES, TERM=327L, 


LEVEL= (0,255) ,DCB=DCB3274L,RLN=1, 
SCRSIZE= (24,80, 43,80) 


SNA Local 


CCE3274S DCB CSORG=TR, DDNAME=DD3274S, MACRF= (G,P) 


G32274S GROUP CEACING=5, BUFSIZE=2000, EUFOUT=2, BUFMAX=2, 
MH=SNAEDSMH, TRANS=EBCD 


P3274S TERMINAL TERM=FULC,ACTIVE=NC,LLAT=(1,6) , TCB=[CCE3274S, 
BFRPAD=23,MAXBFRU=4 


L3274S2 TERMINAL TERM=LUNT, ACTIVE=(YES,NO) ,LCCALLR=2,QUEUES=CRT, 
TCMSESN=NORMAL, RLN=1,GROUP=G3274S,QEY=T, 
LED=YES,0SS=SCS, FEATURE= (NOBREAK,NOATTIN) , 
SECTERM=YES, SCRSIZE= (24,80,43,80) 


G3271BSC GROUP MH=BSCEDSMH, BUFMAX=2,BUFSIZE=2000, BUFOUT=2, 
FCI=(,N) , TRANS=EBCT 


C3271ESC TERMINAL RLN=1, TERM=327C, QBY=T, GROUP=G3271BSC,ACTIVE=NO 


£3271BSC TERMINAL RLN=1,TERM=327R,QOBY=1, GROUP=G3271BSC,QUEUES=DRT, 
ACTIVE=NO, SECTERM=YES, LEVEL= (0,255), 
SCRSIZE= (24,80, 43,80) 


INTRO MACRC INSTRUCTICK 


The INTRO macro supplies the bulk of TCAM initializaticn information, 
including the type of lines. Code the LINETYPE= operand on the INTRO 
macro aS indicated in Figure 5-9. 


CCNTROLLING THE 3270 NETWORK 
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After defining the 3270 system tc TCAM, you use the TCAM Message Handler 
(MH) macros tc process and control the I/O for 3270 systems. The 
following sections discuss some aspects of message handling for the 
3270. 


LINETYP Non-SNA BSC 
' Operand Locals Non-NCP 


Note: Support for NCP attachment and SNA locals is 
independent of the LINETYP operand. 


Figure 5-9. 3270 Attachment Modes Supported According to INTRO 
LINETYP Cpferand 
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MESSAGE HANDLING 


TCAM message handler macro instructions can ke used for editing and 
manipulating of data when the data arrives and before transmission. The 
user, however, must design and control the panels and handle the data 
stream. , 


For all but non-SNA local 3270s, TCAM always reads data with a Read 
Modified command. For ncn-SNA local 3270s, TCAM uses either a Read 
Mcdified or a Read Buffer command, depending on how the INVLIST macre is 
coded. 7 : | 


Cutput to a 3270 may originate either in an application prcegram or ina 
message handler. 


Ncrmally, a TCAM application program generates all 3270 data streams as 
if they were gcing to ke sent to an NCP-attached remote BSC 3270 (Escape 
character, command character, WCC character, data, and orders). In the 
message handler, the macros described below and other message handler 
Macros are used to convert the data stream to the format expected Ly the 
destination staticn. For each type of attachment, a brief description 
cf the conversions necessary follows: . 


e Non-SNA Locals: Set up the channel command with the RETRV function 


of the SCREEN macre instruction; then delete the Escape and remote 
command characters with the MSGEDIT macro instruction. 


6 SNA Clusters: LTelete the Escape character with the MSGELIT pmacro 


ae ae wee ater ae <> aap ener amiy eae 


instructicn. 
e NCP Remote BSC: Ne ccnversion necessary. 


ri Non-NCP Remote ESC: Use the MSGFORM macro instructicn to frame the 


<P ee cenee eae ane ee ame a care aree ag GU. axe a ae. aap 


data stream with STIX and ETX characters. 
In the input side cf the message handler, ccntrol unit and device ID 
Characters are deleted from the data streams sent in ky BSC 3270s. Once 
this is done, input data streams have the same format regardless of 
station attachment mode. 
Certain message handler macrcs perform special or critical functions for 
3270 data streams. These macros are descriked kelow. 


MSGFORM Macro Instructicn 
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The MSGFORM macro instructicn is used in output message handlers for the 
following types of attachment, as indicated: 


e For non-NCE remote ESC 3270s 
Supplies the framing characters (STX, ETX) for a data stream if it 
does not already include them, and breaks messages into tlocks 
(ending in ETE). 

@ For remote BSC extended 3270 data streams 


Causes the data stream tc be sent in transparent mode. 


The MSGFORM macro is not used for local or SNA 3270 devices. 


146 


SCREEN Macro Instructicn 


The SCREEN macro instructicn is used in the output message handler for 
the following types of attachment, as indicated: 


e For local non-SNA 3270s 


To set up the channel ccmmand used to write the data stream that 
corresponds to the remote command found in the data stream. 


e For all 3270s 


To set the command used to write the data stream to the command 
specified on the SCREEN macro instruction. 


MSGLIMIT Macro Instructicn 
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Fer non-NCP attached ESC 3270 devices, code the MSGLIMIT macro in the 
input message handler. On input, MSGLIMIT 1 forces TCAM tc the next 
entry on the folling list. If MSGLIMIT 1 is not coded and device status 
is generated, a locp cculd result with specific polling because TCAM 
rerclls the device. 


HANDLING REMOTE PRINTERS 


In a normal print operation, an application frogram sends a message for 
a non-NCP BSC 3270 printer to the TCAM message control program, which 
Flaces the message on the printer queve. When the message has arrived 
at the printer buffer, the remote 3271, 3274, 3276 returns a WACK. MTCAM 
Marks the message as ccuplete, and the buffer's contents are dumped to 
the printer. When the printing is completed, the printer sends device 
end status to indicate that it can now accert the next print command. 


If a printing error occurs, some portion of the message may te lost, 
even though TCAM has marked the message as ccmplete. You must provide 
cede in the input message handler or application program that scans 
input SOH%R sense/status messages, reccgnizes printer errcr conditions, 
and resends messages that may not have printed successfully. 


If another message arrives at the printer gueve while a printout is 
cccurring, TCAM tries to send the message. The respcnse is a WACK, and 
TCAM merely reschedules the message without informing your 
message-handling program. 


This is, in effect, a lcop until the message currently being printed is 
ccmpleted. You should ensure that only one message is sent to a printer 
at a time, either Ly centrally rcuting all frinter messages through cne 
application program or Ly hclding the printer's queue after a message is 
sent until Device End status is received. 


HANCLING OTHER TYPES OF PRINTERS 


There are similar considerations for sending messages tc 3270 printers 
attached to TCAM in the cther attachment modes supported. See the TCAM 
manuals for more informaticn. 
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HANDLING THE AID EYTE 


Fressing any of the PA cr PF keys, the ENTER key, or the CLEAR key 
transmits a message to TCAM. Pressing a PA key or the CLEAR key sends 
cnly the AID byte, follcwed Ly ETX. Pressing the PF key or ENTER key 
sends the AID byte and all data that has the modified data tag set. 


HANDLING SENSEYSTATUS CONDITIONS 


The 3270 sends a senseystatus message to the incoming message handler 
program when any of the follcwing occur: 


® ICAM addresses the device during the 2 milliseconds that the device 
is busy after the cperatcr fresses a key. 


e TCAM is sending data to a device and an error occurs. 
@ TCAM is polling and a device is turned cff and then turned on again. 
9 A printer ends a frint creration, with or without an error. 


TCAM retries addressing errcrs six times. A control unit's line control 
responses tell TCAK when status is pending. 


If TCAM addresses a device and receives a Reverse Interruption (RVI), or 
sends data and receives an ECT, sense/status is pending for the device. 
TCAM sets the appropriate Mesage Error Reccrd (MER) bits fcr a permanent 
error and sends the message through the output message handler (for an 
RVI) or a zero-length error buffer through the output message handier 
(for an EOT). The reascn for the error message is not yet known, Lut 
you should issue a HOLE so that the current message is not lost and 
additional IyvyC is not attempted until the sense/status message is 
interrogated. | 


ICAM stops all activity on the line and does a specific fell of the 
device in questicn, referring to the invitaticn list. The sense/status 
message is posted to the message handler with the SOH&EC cr SOHAR Fit 
set in the message errcr reccrd. You must analyze the sense/status 
message and take corrective action, as discussed below. 


If TCAM cannot poll successfully, a zerc-length buffer is sent through 
the message handler. ‘You shculd take action forcing TCAM tc stor 
communicating with the device until the p~rcbiem is fixed. All 
senseystatus messages appear at the incoming message handler. 


If the device is busy and TCAM receives a WACK in respcnse to 
addressing, the operaticn is rescheduled. However, te optimize line 
use, HOLD should be used specifying a time interval to minimize WACK 
responses. | oe 


It is advisable to have a separate applicaticn frogram to handle status, 
rather than to try to include such programming in the message handler 
Programs. If necessary, the application can work with cperator control, 
issue QRESET, MRELEASE, and ICHNG macro instructions, and retrieve 
messages. 


If a permanent errcr occurs on the outgoing side of the message handler, 
record the pending status in an cption field for the terminal until the 
sense/status message arrives at the input message handler. If an 
unexpected senseystatus message arrives, you may need tc issue a QRESET 
macro instruction to resend a message that had been marked as complete. 
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In the OUTMSG sukgrour, specify a short duraticn (INVYTL) fcr the HOLD 
Macro instruction if a high percentage of cases requires retrying. 
After three retries, issue a permanent HCLL. An ERRORMSG exit to an 
application program is frokakly required tc release the device. The 
exit must be to a valid destination or the exit is not taken. 


ICAX FACILITIES FOCR ERFCR HANDLING 
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TCAM haS varicus facilities fcr error handling, which can ke divided 
into three classes: kasic cperator control commands, message handler 
macros, and TCAM applicaticn frogram macrcs. 

8 Basic operator control ccmmands 


VOFFTP/VONTP - Commands used to halt and restart communiation 
with a device or devices on a line or all lines in a group. 


e Message handler macro instructions 


HCLD - Holds a TCAK message queue so that TCAM will not send 
messages cn a held gueue to the associated device until the 
queue is released. 


CANCE] - Cancels the current message being processed by the 
message handler. 


ERRORMSG - Generates a message from within a message handler to 
a specified destination (such as an error handling applicaticn 
program). 


IEDPSTOF - Stcps polling of a specific device. 


IEDVOFF - Storfs ccumunication with a device or with all devices 
on a line. 


IEDRELS - Releases a held message queue; any messages on the 
queue will sukseguently ke sent. 


SLOWEOLL - Susfends polling on a line for a specified interval. 


e ICAM applicaticn frogram macros 


MRELEASE - Releases a held message queue; any messages on the 
queue will suksegquently be sent. 


ICCPY - Copies a line's invitation list into apfplicaticn 
program storage for examination. 


ICHNG - Changes a line's invitation list; for example, makes a 
device's entry inactive or changes a device's folling 
characters. 


POINT - Used tc set up message retrieval for data stream error 
analysis. 


QCOPY - Ccpies a device's queue centrel blocks into application 
program storage for examinaticn. 
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QRESET - Marks messages previously marked complete as not sent 
so that they will ke resent. 


TCOPY - Copies a device's terminal tatle entry control block 
into applicaticn frogram storage fcr examinaticn. 


TCHNG - Changes a device's terminal takle entry ccntrol tlock. 


There are similar errcr conditions and tasks to be performed for the 
other forms of attaching 3270s to TCAM. For NCP BSC 3270s, SOH&R 
sense/status messages flow through the input message handler as for 
ncn-NCP BSC 3270s. For LU.1T0 3270s, device sense/status is returned to 
TCAM in the user sense field of SNA excepticn responses and requests. 
For LU.T2 3270s, errors and status are reported to TCAM via SNA 
exception responses and LUSTIAT DFC requests. For all these forms of 
attachment, refer to the TCAK publications for more information on how 
to handle status and errcrs, and to the 3270 Component Lescription for 
information on errors and status sent by 3270 stations and the form in 
which the information is encoded. 
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The Virtual Telecommunicaticns Access Method (VTAM), Advanced 
Communication Functicn (ACF/VTAM), and Advanced Communicaticns Function 
VIAK Entry (ACF/VTAME) are access methods that can ke used in the 
telecommunications management of the 3270 display system. They support 
Ecth local and remote 3270s under DOS/VS, OS/VS1, and OSy/VSZ. ACF/VTAM 
and ACF/VTAME provide large screen supfort for the 3278 and 3276 
displays plus the LOGKECIE capability in record mode. ACF/VIAME supports 
Cclor, Extended Highlighting, and Programmed Symbols for SNA devices 
cnly. 


The VTIAM, ACF/VTAM, and ACFyVTAME publicaticns listed in the preface to 
this manual are reguired for: 


@ A detailed introducticn to VIAM and a definition of the appropriate 
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e An explanaticn of hcw tc define a VTAM network that includes 3270s 
(the DOS/VS, OS/VS1, or OS/VS2 ACF/VTAM, or VTAM System Programmer's 
Guide) 


e An explanation of how to write a VTAK application frogram that 
communicates with 3270 terminals uSing VTAM (VTAM Macre Language 
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Fer explicit informaticn on how to generate each 3270 device, see IBM 
704 and 3705 Control Program Generaticn and Utilities Guide and 
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Reference Manual for VTAM and ACF/VTAM. 
This chapter is cnly a summary of the VTAM information for the 3270, and 
should be used in conjuncticn with the VTAM fublications. The chapter 


discusses the considerations for a 3270 in a network using VTIAM, and 
describes: 


e VIAM Support for the 3270 

e iepearanee of the 3270 in VTAM Record Mcde 
@ Defining the 3270 

e Managing the 3270 

e Figrating from Ncon-SNA to SNA 3270s 


For detailed reference material, see the IEM 3270 Information Display 


VIAM can coexist with ETAM under DOS/VS and with BTAM and TCAM under 
CS/VS. ETAM frograms that dc not use the ccmmunications ccntroller in 
network control mode can ke executed concurrently with VTAM as lcng as 
they have telecommunication netwcrks separate from VTAM's. With this 
ccncurrent execution, a single application program can use Loth BTAM and 
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VTAM or TCAM and VTAM to communicate with 3270 devices, previded that 
all the reguirements of both access methods are met. 


ETAM and VTAM can operate ccncurrently only in separate networks. For a 
detailed description of TCAM programs under VTAM, refer to WIAM Concepts 
and Planning. Note, hcwever, that ACF/VTAM does not provide support for 


Three major classes of 3270 control units are supported by VTAM. (See 
Figure 6-1.) They differ in their means of physical attachment to the 
hcest and in their SNA capakilities. There are two classes of SNA 3270 
ccntrol units. The first is called a physical unit type Z (BU.T2); it 
is an SNA control unit, which can attach by a 370 channel or by a 
switched or necnswitched SPLC link; it supports logical unit types 1, 2, 
and 3 for its terminals. The other SNA ccntrol unit is called a 
Fhysical unit type 1 (EU.1T1); it can attach only by a ncnswitched SDLC 
link and supports cnly type 0 logical units fcr its terminals. fThe 
final class of 3270s ccnsists of non-SNA control units; they can attach 
by a 370 channel or a ncnswitched BSC link. Although these control 
units do not directly support SNA, VTAM (with some excefticns) and 
ACF/VTAM programming fermit the non-SNA 3270 terminals to appear to the 
VIAM application program as if they were type 0 logical units (that is, 
to appear the same as terminals attached to a PU.T1 3270 ccntrol unit). 


With minor exceptions the data streams for all three 3270s appear the 
same to a VTAm applicaticn frogram. Also the SNA protccols used by the 
type 0 LUs are the same for the PU.T1 and non-SNA 3270 terminals. 
However, different prectccols are used for the FU.T2 logical units (LU 
types 1, 2, and 3). The data streams and protocols are discussed in 
detail in the Component Description manual. Scme of the key differences 


retween type 0 and tyre 2 lcgical unit protocols are discussed in 
following sections. | 


DEFINING THE 327 
CEFINING THE LOCAL NCN-SNA 3270 

A set of local non-SNA 3270s is one of the types of major ncdes you can 
define to VTAM. 

VTAM'S LOCAL definiticn statement provides definitions cf local non-SNA 
Major nodes. A LOCAL statement defines either one printer cr one 
display unit; each locally attached non-SNA 3270 terminal must be 
defined by at least one LCCAL statement. The LOCAL statement provides 
the following informaticn: , 

e The name of the terminal 

e The channel and unit address of the terminal 


e The features available cn the terminal 


@ The name of the interpret table to be used in analyzing logon 
reguests for the terminal 
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Control Unit Model Profile Subsets Record Mode Data Stream Content 


Out 
3271-1,2 FMP=2 SEND/RECEIVE | CMD | wee | Data | 
3275 - 1,2 TSP=2 
3274 -1C ,51C | in 
3276 - 1,2, 3,4 AID | Cur Addr | Data 
< LU.TO 
2 
g aes | NETSOL LOGON 
< 3272 -1,2 Channel ae 
3274 - 1B,1D 
USS (3270) 
If PU=YES , LOGON 
for BSC only 
| Out 
PU.T1' FMP=2 SEND/RECEIVE | CMD | wee | i | 
SDLC TSP=2 


3271-11, 12 


3275-11, 12 AID Cur Addr Data 


LU.TO 
| | - LOGON 
USS (3270) 
: LOGOFF 
 § 
az mn Gan ee 6 | een Cc CE GEES GHEE CGM aontNERED 86 SEDO | Gen 
Jp] 
FMP=3 Out 
PU.T2 ; re SEND/RECEIVE | CMD | WCC | Data | 
3274-1C,51C LU=2 In 
3276 - 11,12,13, © LU=3 
14 = AID Cur Addr Data 


LU.T1, LU.T2, LU.T3 


USS (SCS) 


LOGON 


LOGOFF 
PU. T2 


| 3274-1A 


'ACF/VTAME does not support PU.T 1. 


Figure 6-1. VIAM Supfrort Summary 
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@ The name of an applicaticn program to which VTAM is to automaticall 
transmit a logcn fcr the terminal whenever the terminal is availabl 
for connection. (VIAM can automatically submit a legon if this 
option is used. The apfrlication program can be the IBM network 
solicitor (NETSOL), a user-written network solicitor, or the 
applicaticn program name.) _ 


6 The buffer limit fcr the terminal 


a Whether the terminal is to be considered active or inactive when the 
logical set of which it is a part is activated 


© The terminal type: 3277, 3284, or 3286 


8 For ACF/VTAM the name of the logon mode takle to ke used in 
determining sessicn parameters for the terminal in a record mode 
session and a default logon mode name 


If you are defining a lccal non-SNA 3278, 3287, or 3289, you must use 
the LOCAL macro and define the 3278 or 3279 as a 3277, the 3287 as a 
3284, and the 3289 as a 3286, since these are the only devices 
reccgnized as valid operands. 


An LEUILD statement identifies a set of local 3270s as a major node. 
The LBUILD statement and the LOCAL statements that define the 3270s in 


—e COE” am coe eam ace 


of the VIAM definition library. Figure 6-2 illustrates the defining of 
leocalnon-SNA 3270s. | 


LEFINING THE ESC 3270 

A CLUSTER and a TERMINAL definition statement define the BSC 3270 
terminal. These statements can specify to VTABE: 

s The name of the terminal 

« The features of the terminal 


e Automatic logon and interpret table requirements 


@ The initial status of the terminal or cluster control unit when VTAM 
activates the NCP 


a Logon mode table and default logon mode name requirements (ACF/VTAM 
and ACF/VTAME cnly) 


@ USS definition takle requirements (ACF/VTAM and ACF/VIAME only) 


The TERMINAL definiticn statement when used tc define printers and 
displays must specify any of these as a 3277, 3284, or 3286, since these 
are the only terminals that are valid operands. (For example, if your 
cluster includes a 3287, you should specify it as a 3286.) 


The CUTYPE operand on the CLUSTER macro accerts only the 3271 as valid; 
therefore, if you wish to specify a 3274 Model 1C, 3274 Model 51C, or 
3276, substitute a 3271 as the operand. 


PHYSICAL CONFIGURATION. 
CPU 


Control 
Unit 


‘Channels 


Terminals (locally 
attached 3270s) 


NETWORK DEFINITION 


Definition Statements 


LOCAL 
Statements =i 


Terminal 1 


LBUILD 


Terminal 6 
LOCAL 
Statements 


Terminal 4 


LBUILD 
LOCAL 
Statemens ing 


VTAM 
Definition 
Library 


Member 1 


Member 3 


LBUILD | 
A logical set of locally attached 3270s is defined 
: , to VTAM by filing an LBUILD statement along 


with the LOCAL statements for the terminals in | 


the set. In this example, three logical sets of 
local 3270s are defined. 


Figure 6-2. Grouping Locally Attached 3270s into Logical 


Sets. 
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LCGCN RECUESTS (ESC and Local Attachment) 


The network solicitor acts as VTAM's logon monitor facility for locally 
attached and BSC 3270 terminals assigned to it (if PU=YES is not 
specified). To assign a 3270 to the network solicitor, specify the name 
cf the network solicitcr in the APPL operand of the LOCAL statement for 
the local 3270 or in the LCGAEPL operand of the TERMINAL statement for 
the ESC 3270. (NETISOL is the name of the IBM-supplied network 
sclicitor.) 


When the terminal cperator enters a message at the 3270 terminal, the 
network solicitor determines whether the message is a valid logen 

request by checking an interpret table. If the message is valid, the 
network solicitor passes the reguest to the logon exit routine of the 
application program specified in the interpret table fcr that message. 


Note: NETSCL does not exist in the ACF/VTAM Release 2 or ACF/VTAME. 


te: If no interpret table is specified and the operating system is 
/NS, the network solicitor checks the message for usual format. If 
the message is the usual logcn, the network solicitor fasses the 
terminal to the applicaticn frogram specified in the message itself. 


If the logon message is invalid, if the application prcgram associated 
with the message is not active, or if that program is not accepting 
logons, the network sclicitcr notifies the terminal operatcr that the 
logcn has been rejected and invites the operator to enter another logon 
message. 


Figure 6-3 diagrams the network solicitor's processing cf a 3270's logon 
message. For more infcrmaticn about the netwcrk solicitor and interpret 


ae ae ae ao — ane ae ae ae come —_  < 0 enee ee a aut que ane 


Termirial operator enters logon from 
active Non-SNA terminal. 


NETWORK SOLICITOR 


The network solicitor compares the 
logon from the terminal operator 
with the logon definition for that 
‘terminal. 


Does the logon request 
match a logon defined 
for the terminal? 


No Yes 


Pass the request to the logon 
exit routine of the application 
‘program specified through the 
logon definition. The network 
solicitor passes the request 
only if the application program 
has an open ACB with MACRF= 
LOGON specified and has 
issued a SETLOGON macro 
instruction with the OPTCD= 
START specified. | 


Figure 6-3. Processing a Terminal-Initiated Legon with the Network 
Solicitor 


‘Inform terminal operator of 
invalid request. 
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DEFINING AN SNA 3270 


Io define the SNA 3270 control unit and its terminals, use the same 
statements (PU and LU) and the same tables (USS definition table and 
lcgcn mode table) that you use to define other SNA devices. 


When defining the SNA 3270 devices you should refer to the appropriate 
System Programmer's Guide fcr details; you can use the follewing 
guidelines for the varicus ccntrcl units. 


PU Crtions 
For the 3276 Models 11, 12, 13, 14 use PU parameters associated with 


PU.1I2 support. 


For the 3276 Models 1A, 1C in SDLC use PU parameters associated with 
PU.T2 support. 


For the 3271 Models 11, 12 use PU parameters associated with PU.T1 
Support (not supported Ly ACF/VTAME). 


For the 3275 Models 11, 12 use PU parameters associated with PU.T1 
Suprort (not supported Ly ACF/VTAME). 


LU Cptions 


The LU types are 


Type 1 - the device attached to the 3274 or 3276 is a printer and 
the data stream is the SNA character string (SCS). 


Type 2 - the device attached to the 3274 or 3276 is a 
keybcardydisplay and the data stream is in 3270 data 
stream ccmpatiktility format. 


Type 3 - the device attached to the 3274 or 3276 is a frinter and 
the data stream is in the 3270 data stream compatibility 
format. 3 


For the 3276 Models 11, 12, 13, 14 the PU and LU parameters for switched 
line support apply. 


For the 3274 Models 1A and 1E LU local statements apply. 


Fer the 3276 and 3274 SILC attachments are defined like any other LU 
types. 


Lcecal SNA 3274s (Model 1A) must ke specified as a 3791 cn the IOLEVICE 
system macro in OS/VS systems and on the DVGEN macro in DOS/VS systems. 


Ycu can specify unformatted system services (USS) definiticn takles for 


the 3270 terminals asscciated with an SNA 3270 controller; with the 3270 
ccntroller, USS monitcrs all traffic on the SSCP-LU session. 


157 


HANAGING THE 327 


CATA TRANSFER KODES 


Tc communicate with a ncn-SNA 3270 through VIAM, an application program 
Can use either of two mcdes of data transfer: kasic mcde cr record 
mode. (If PU=YES was specified, only record mode can be used.) Easic 
-mede suprorts only the non-SNA 3270s, but a program can use record ncde 
to communicate with kcth ncn-SNA and. SNA 3270s. Using record mode with 
ncen-SNA 3270s permits the VIAM (with some exceptions) and ACF/VTAM 
application program tc communicate with ncn-SNA 3270s using the same. 
VIAM instructions as these used to communicate with the SNA 3270s. 


Ncte: Basic mcde is not supferted in ACF/VIAM Release 2 and ACF/VTAME. 


CATA TRANSFER USING RECORD MODE 


The 3270 terminal is treated as a logical unit if the NIB's MODE field 
is set to RECORD (indicating record mode) when the terminal is connected 
ky CPNDST. Using record mode, the VIAM application program exchanges 
messages and responses with SEND and RECEIVE macro instructions. The 
application program cannot use any kasic mode macro instructions with 
terminals connected in record mode. An apflication pregram using. 
ncn-SNA 3270s can communicate with different devices on the same ccntrol 
unit in different modes at the same time if PU=YES was not aa 
Ncn-SNA 3270 devices can also he disconnected in one mode and 
reconnected in another if PU=YES was nct specified. 


With record mode, the application program can ke independent of whether 
the 3270 is locally cr remotely attached, because VIAM deletes all line 
ccntrol characters sent from remote devices. | | 


Some restrictions apply to all SEND, RECEIVE, and SESSICNC communication 
with the 3271, 3275, and 3277. These restrictions are described in the 
"Considerations" secticns below. | 


Since in ACF/VIAM logon mode tables are used for all record node 
sessions, even those with ncn-SNA 3270s, care must be taken that any 
legcn mode name used fcr a session leads to a valid logon mode takle 
entry for the sessicn. If ne logon mode name is specified for the 
terminal (either directly or indirectly) a default set of session 
parameters is used. See the ACF/VIAM System Programmer's Guide for 
further informaticn. = "7 


Nete: It might be necessary to udpate the LCGMCDE entry to specify the 


Frimary and alternate screen sizes for new devices if the application 
program requires that infcrnmaticn. 


<p ane a ae ae ae aes ae enw 


The following is an example cf 3270 input and output data using the SEND 
and RECEIVE macro instructicns. 


Cn ccmpletion of the KECEIVE macro instruction: 


RECEIVE RPL=(2) ,RTYPE=CFSYN, AREA=AREA1, AREALEN=100 


the program could lcck in the RECLEN field of the RPL fointed to Ly 
register 2 to find the exact length of the data received in AREA1. 
AREA1 might contain data in this format: 


eee ee Fa ge ere eg er ae ge ee ge ee 7 
[ | Cursor [ | Buffer | Trust Account | 
{| AIC {| Address | SEA | Address | Numker { 
[ enn eee eee nee a Ween le es 


The AID might indicate a particular processing routine that was 
required, such as a trust account informaticn frogram. The reply to 
this input, prepared Ly the trust account information frogram, might 
consist of data in the following format: 


er as ee te ee ee pe es” ge 7 
| Erase/y | { ( 
{| Write ] | | 
{ Char | WCC | Crders and Text | 
We ae a das his es cer ome is ie Sas ean 


and be sent with this macrc instruction: 


SEND RPL=(2),STYPE=REQ,AREA=AREA1, RECLEN=50,0PTCD=ASY, 
PFOST=RESP, ECE=ECB1,RESFOND= (NEX, FME) 


When VTAM determines that the message has arrived, it posts ECB1. 
(ECST=SCHED could also ke specified and completion determined Ly 


receiving a respense with a RECEIVE(RTYPE=RESP) or as a result of VTAM 
scheduling the program's RESE exit routine.) Note that VIAM inserts a 


kinary synchrcnous ESC character in front cf the Erase and Write (or 
cther) ccmmand character for remote BSC 327Cs. 
Language Guide for 


Nete: Refer to Sample Program 2 in the VTAM Mac 


BK Ba 
another example of communicating with the 3270 
mcde macro instructicns. 


ro 
te 


Input Considerations fcr Non-SNA and PU.T1 3270s (LU.TO) 


rminals using record 


The VIAM applicaticn program can receive no SESSIONC commands from the 

3270 terminal. The applicaticn frogram sends cnly the Clear command to 
the 3270. The Clear ccmmand resets both incoming and outgcing sequence 
numbers to 0, terminates any current bracket, and allows data traffic to 


ccntinue. While a Clear is in progress, data traffic is not allowed; 


the applicaticn program gets a return code to this effect (RTNCD=20, 
FDBK2=65) if it attempts to send data while CLEAR is in Pregress. 


If the application program has no use for brackets, the entire interval 
ketween the first I/C request following connection or CLEAR, which must 
begin a bracket, and disconnection can be ccnsidered tc be one bracket. 
The BIND parameters can also indicate that Erackets are not to ke used; 


for non-SNA 3270s this is available only with ACF/VTAM. Both the 
application program and the 3270 can begin a kracket, Lut cnly the 


application program can end cne. The applicaticn program can begin and 


end a bracket with the same message; that is, it can specify 
ERACKET=(EB,EB) for the SEND RPL. 
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The first input from a local non-SNA 3270 or a remote 3270 while not in 
bracket is marked as the beginning of a bracket. This input includes | 
any power-on device end condition that is passed to the application 
program aS an excepticn reguest message after OPNDST. All subsequent 
messages received from the 3270 indicate that the kEracket is heing 
continued; only the application program can end the bracket. 


If toth the applicaticn program and the 3270 attempt to kegin a tracket 
at the same time, or if the application prcgram attempts to begin a new 
ktracket without ending the current one, the response to the application 
program's SEND indicates Reguest Reject (SSENSEI=RR). If the 
application program sends an NBB bracket indicator while nct in a 
btracket, a STATE error (SSENSEI=STATE) is returned. 


When the SEND data stream contains a 3270 Read command, the resulting 
input is received as a separate message, not aS a response to the SEND 
cperation. The application frogram should not Legin or end a kEracket 
when the data being sent contains a Read ccmmand. The application 
Frogram must request a definite response to each message sent to the 
3270 that begins or ends a kracket. A definite response is requested by 
setting RESPOND=(NEX,FMNE,NREN) for the SENT RPL. A definite response 
should also be requested when a message is sent to a printer. All other 
cutput can indicate that either exception responses only -- 
RESEOND= (EX, FME,NRRN) -- or definite resfpenses -- RESPCND=(NEX,FME,NRRN) 
-- are expected. TLefinite Response 2's (formerly called RRN responses) 
are not used. Only single-element chains can ke used. 


SNA and PU.T1 3270s (LU.TO) 


Nete: The restricticns noted in this secticn do not apply tc the SNA 
3275/3276. For informaticn cn SNA considerations see the ACF/VTAM and 


LP <P AD ag ae EP — 2» a= a2 ame ww ae ase a —_- ae ae ae ene ane ane am om ame ans ae ae ——- <> au ane 


The application program must place all 3270 commands and orders in the 
output data in the format expected by a BSC 3270 except for ESC; that 
is, everything, beginning with the command code, is used as though the 
3270 were a BSC 3270. BSC ccmmunication ccntrol characters are provided 
ky NCP or ACF/VTAME. | 


A SEND macro instructicn may point to a data area containing a Read 
Mcdified command to be sent to the device. The data retrieved from the 
device is placed in the application program's storage area of a 
suksequent RECEIVE macro instruction in the format: 


oS Te a Tgp EE Oe EE NR ag Oe Ee eh ne Ge ee Se ee a ee a ee ee 
| AID | CUR® | CUR2 | device control characters,orders,text | 
a ae a a a a i a lc a se i Sl ee es nl cin a 


STE SM. a anata Si Seas op aes es 


AIC is the attenticn identification byte and CUR! and CUR? form the 
2-Eyte cursor address. If the terminal operator causes a "short read" 
to occur at the terminal (by pressing the CLEAR key or a Program Access 
key, for example), the input data consists cf the AID byte only. 


No responses may be sent to the non-SNA terminal unless your system 
includes a 3274 or 3276 Control unit. All incoming messages indicate 
that no response of any type is expected (RESFOND=(NEX,NFME,NRRN)). 


Messages sent to the 3270 shculd contain cnly data and control 
Characters for the 327C. No SNA data flow control commands, such as 
Cuiesce, Signal, Bit, Chase, or Cancel commands should be sent; that is, 
cnly CCNTROL=DATA is allowed. If the application program attempts tec 
send one of these commands, the SEND is completed with RINCLD=20 and 
FDBK2=71. The terminal may return a negative response. Eracket 
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ies 


indicators are used as described above in "Input Considerations." 
Chaining indicators must always mark the message as the sole element of 
a chain; that is, CHAIN=ONLY. The format indicator (OFTCD=FMHDR) and 
direction indicator (CHNDIR) are not used with LU.TO and should te set 
to 0. 


When a Copy Command is placed in the data stream for a BSC or SDLC 3271, 
remote BSC 3274 or 3276, the application frcgram must include the 
Fhysical device address of the "from" device. It can obtain this 
address by issuing INCUIRE (CFTCD=DEVCHAR). Note that a ccfy operation 
is not valid for a locally attached 3270 terminal and should not be used 
in an application program that is intended to te attachment-independent. 
Also this device address information is not available by INCUIRE if the 
3270 is owned by a TCA¥F system in a multi-systen networking 
configuration. 


When using the Copy ccmmand to oktain a printout on a 3288-2 or 3289 
printer, remember that varicus print belts can be installed on this 
Frinter. 


Network Solicitor Considerations 


—_~ ow ee aww ae om oe — ee ame aay aap ame em ap ane. a 2 aw ase am eww a ee ee oe ae ae 


Lcegcn requests for the non-SNA 3270 originate from these 3270 terminals 
(unlike a logical unit) by means of the network solicitor. When PU=YES 
has keen specified, the network solicitor cannot he used, and USS logen 
is provided by means cf the ENTER key or magnetic card input. (For SDLC 
3271 and 3275 USS poe and logoff are provided Ly means cf the system 
request key.) 


If a non-SNA 3270 device is folled and the 3271, 3274, or 3276 control 
unit is not powered-on, the terminal is disconnected from the network 
solicitor. When the 3270 device and ccntrol unit are subsequently 
powered-on, the user must call up the network operator and request 
NETSOL connection with a VARY LOGON ccmmand, if the network solicitor is 
tc ke used for the device. 


CAUTION: If a 3270 terminal is in session with a VTAM application 
“Ereogram, the terminal creratcr must terminate the sessicn before 
Switching off the terminal. If the operator turns off the device kefore 
successfully terminating the session and before a general foll reaches 
the device, no status is returned until the device is turned kack on; 
thus, another terminal cperator could turn cn the 3270 device and have 
access to the first terminal operator's session. If, hcwever, the 
application issues a SEND tc the device, an error indicaticn is 


received. 


Sense and Status Information 


Status and sense information will be available in the RFL's USENSEI 
field when an excertion request or response is received. The format of 
the information is shcwn belcw. The 2 high-order bits of each byte are 
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set to 0; this makes it easier to design the applicaticn Frogras te ke 
independent of the terminal's mode of attachment. | 


First Seccnd 

byte byte Neaning 

08 00 Levice busy 

04 00 Unit specify 

02 00 Levice end 

01 00 Transmission check 
C0 20 Command reject 

00 10 Intervention required 
C0 08 Equipment check 

00 04 Data check 

C0 02 Control check 

00 | 01 Oferation check 


Only the low-order 6 Lits of each byte are Significant. These kits may 
be set in combinaticn and shculd be tested individually 


The SSENSEI (system sense) field is set following the receirt of 
exception responses (see VIAM Macro Language Reference for complete 
SSENSMI settings). The SSENSEI field can be set to indicate a PATH 
error (SSENSEI=PATH), a STATE error (SSENSEI=STATE), a Request Reject 
error (SSENSEI=RR), a Functicn Interpret error (SSENSEI=FI), or no 
system error (SSENSEI=0). In the case of SSENSEI=0, the USENSEI field 
should be used to determine the cause of the exception condition. 


CATA TRANSFER USING EASIC MCLE 


In basic mode, the MODE field of the NIB is set to BASIC when the 3270 
terminal is ccnnected. In kasic mode, the VIAM application program 
exchanges data using READ and WRITE macro instructions; the program 
cannot use any record mode macro instructions with terminals connected 
in kasic mode. It can, however, communicate with different devices on 
the same control unit in different modes at the same. A 3270 device can 
also be disconnected in cne mode and reconnected in the other. Basic 
mode cannot be. used if FU=YES is specified. | 


Eecause VTAM deletes all line control characters sent from remotely 
attached devices, input processing does not have to consider whether the 
device is locally cr remctely attached. : 


— «me —_ SP A A CEP CAEP AES ERD GD ee aD aE NP ee 


| 


To avoid losing incoming data when the input area is too small, specify 
the KEEP processing oftion in the NIB used to connect the device. Then 
if the data is too long, VIAM fills the input area, sets the second bit 
(DATAFLG=EOB) of the FIEK field off, and holds the remaining data for 
the next read request. 


To send a Read Buffer command to a terminal, use a DO macro instruction 
that pect tice an LDO with CMD=READBUF. The data in the application 
Frogram's input area upon completion of the [C macro instruction is in 
the format: 


rie <a a 


ee pie ECE 
{| AID | CUR® | CUR? { SF { ATTR | text | 
A Lene! Lene Cee! A Eo ewe Namen een eT 
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AIL is the attenticn identification byte and CUR! and CUR2 form the 
2-kyte cursor address. The SFs (Start Fields) and ATTRs (attribute 
kytes) are present only if the device kuffer is formatted. 


—_ = ae —_ =~, <a ES Ge cE KE KO coer ee ee OE ee amp came aie. 


The four output operations available are selected Ly setting the 
EFRASE-EAU-NERASE-CONV crtion code in the REL cf a WRITE macro 
instruction: 


a WRITE (OPTCD=ERASEF) clears the device's entire buffer, and then 
fills it with the cutput data whose address you provide in the RPL*'s 
AREA field. At the beginning of that data, you must provide the 
Write Control Character (WCC) followed ky the approfriate device 
control characters, orders, and text. RBecause you set the 
BLK-LBM-LET option code to LET, do not select the emkedded line 
control character cftion. 


@ WRITE (OPTCD=EAU) sends an Erase All Unprotected command to the 
device. Recause this fcrm of WRITE invclves no outpfut data, set the 
RPL's RECLEN field to 0. 


@ WRITE (OPTCD=NERASE) sends a Write command to the device. You must 
prepare the output data in exactly the same manner as is specified 
above for CPICLI=ERASE: kegin the output data with WCC, followed by 
the aprropriate device ccntrcl characters and orders. 


8 WRITE (CPICLD=CCNV) writes a Elock of data to a terminal and then 
reads a blcck frcem the same terminal. This form of WRITE (the 
conversational WRITE) uses the AREA field of the RPL tc contain the 
address of the output data and the AAREA field to ccntain the 
address of the input data. 


For a Read/Write sequence, the write oferaticn is not suspended pending 
the completion of the solicitation of the device. Instead, the write 
operation is completed and the solicitaticn cf the device ccntinues. 


Cther Basic Mode Ccnsideraticns 
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If a 3270 device is addressed and the ccntrcl unit is nct fowered-on, a 
X¥'CCO1"' return code is received. The terminal is no lcnger usakle and 
should be disconnected. When the 3270 device and 3271, 3274, 3275, or 
3276 control units are subsequently powered-on, the user must call uf 
the network operatcr and request that the ccntrol unit be reactivated 
using the VARY commands. 


If a locally attached 3270 device is polled while it is powered-off and 
the control unit is powered-cn, an error indicator is received. A 
device end status is returned when the device is powered-on. When the 
device end status is received, reissue the request. 
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instruction that are invalid for 3270 devices. 


Set the BLK-LEM-LBT option code (applicable for output) to LET; BLK is 
invalid, and LBM requires that you be aware of whether the device is 
locally or remotely attached (because no line control characters are 
sent regardless of the attachment mode). 
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CAUTION: If a 3270 terminal is in session with a VTAM applicaticn 
program, the terminal operator must terminate the sessicn Lefore 
Switching off the terminal. If the operatcr turns off the device before 
successfully terminating the session and Lefore a general foll reaches 
the device, no status is returned until the device is turned back oh; 
thus, another terminal operator could turn on the 3270 device and have 


access to the first terminal cperator's session. 


Sense and Status Information 


When the terminal sends sense and status information in response to a 
READ, WRITE, or CLO macro instruction, VTAM places the z Lytes of 
information in the RPL's SENSE field. VTAM alsosets the RFEL's RTNCD 
field to 4 and sets the FDEK2Z field to 2 to signal that the SENSE field 
has keen set. The failed cferation may be retried after execution of a 
RESET macro instructicn with CPTCD set to UNCCND or LOCK. 


If the SENSE field is extracted with SHOWCB, the 2 bytes cf information 
are right-adjusted in the fullword work area. The SENSE field ccdes are 
described below; the pcssible hexadecimal values of the 2 Lytes are: 


First Seccad 

byte byte Neaning 

C8 40 Tevice busy 

C4 4Q Unit specify 

C2 40 Tevice end 

C1 4Q Transmission check 
4Q 60 Command reject 

40 50 Intervention reguired 
40 C8 Equipment check 

40 C4 Data check 

40 C2 Control check 

40 C1 Operation check 


Cnly the low-order 6 bits of each byte are significant. These Lits may 
ke set in combination and shculd be tested individually. 


USING VTAM WITH SNA 3270S 


VTAM supports SNA 3270s cn ncnswitched lines cnly with the exception of 
the 3276 on which VTIAF supports the use of switched lines. The 
application program ccirmunicates with the SNA 3270 in record mode. 
Althcugh this 3270 is defined to the application program as a logical 
unit, it has no programming capabilities. All other asfects of 
Ccmmunication with the SNA 3270 are the same as those descriked in the 
VITAM publications for cther SNA terminals (refer to the publications 
listed in the preface to this kook). 


LCGON REQUESTS 


Ico log on from a 3270 (FU.TZ, BU.T1 or non-SNA 3270 for which PU=YES is 
specified), the terminal crerator follows device procedures for getting 
tc the SSCP session. The operator can indicate a logon mode previously 
defined by the installation as valid and specify a logcn message to he 
Fassed to the VTAM application progran. 
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The request the operatcr enters is a character-coded request; that is, a 
request that uses the SNA unformatted system services cf VIAM. To 
specify in a VTAM netwcrk definition that a terminal uses character 
ccded requests, specify SSCEFM=USS3270 in the LU statement defining the 
3270 for PU.T1 and specify SSCPFM=USSSCS in the LU statement defining 
the 3270 for FU.T2. 


When VTAM receives this request, it converts it into a field-formatted 
ccnnection request; that is, a request that uses the SNA fcrmatted 
system services (FSS) cf VIAM. VTAM uses a logon request format and 
related definition takle for the conversion of the request; the format 
and table may be IEM-supplied or defined by the user. Refer to the 
information about request formats and definition tables for USS and 
logcn modes. 


SNA LOGOFF RECUESTS 


To log off an SNA 327C, an installation can write the VTAM application 
Frogram so that it examines each message from the 3270 for a 
predesignated reguest fcr disccnnection or lcgoff. 


Instead of using the predesignated request, the installaticn can alsc 
have the terminal cperator send a logoff request as a character-coded 
system service request Ly using the system request key. This request 
arrives aS a LOGOFF request, which VTAM ccnverts into a formatted 
Terminate-Self command. As with the logon requests, VTAM can use either 
an IFM-supplied or user-defined logoff request format and associated 
definition table. 


NCN-SNA LOGOFF REQUESTS 


An installation can write the VTAM application program to examine each 
message from the local 3270 terminal for a fredesignated request for 
disconnection or logoff request. This logoff request and the LOSTERM 
exit (with return code) are the type of logcff requests surfrorted for 
ESC and locally attached 3270s. 


MIGRATION FROM NON-SNA TO SNA 3270 


Fcollowing are some of the areas that you should consider when migrating 
in a VTAM record mode envircnment from ncn-SNA 3270 to EU.T1 or PU.T2 
3270s or from PU.T1 3270s to PU.T2 3270s. 

VIAM network definiticn: 


CLUSTER, TERMINAL, and LOCAL statements define non-SNA 3270s; PU 
and LU statements define SNA 3270s. 


For PU.T2 3270s, specify SSCPFM=USSSCS; for PU.T1 and for 3270 
terminals for which FU=YES, specify SSCPFM=USS3270. 
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LCGCN data passed to the application program: 


If logon is dcne through the netwecrk sclicitor (ncn-SNA 3270s with 
PU=NO), the whole logon message is passed to the applicaticn 


program. 


If USS is used (SNA 3270s or terminals with FU=YES), only 


the user data part of the logon is passed to the applicaticn 


progran. 


See the VIAM cr ACF/VTAM System Programmer's Guide for a 


limited means (using the interpret function) by which the whole 


logon message is fassed to the applicaticn progran. 


A user-written 


network solicitor can also pass the data part of a logeon to the 


application program. 


LCGON format: 


Any logon message defined for non-SNA terminals should have a 


format acceptable to USS. 
changing the logon format used by the terminal operatcr. 


This will allow migration without 


See the 


acceptable formats and also for a limited means of bypassing this 
requirement by using the interpret function. 


LOSTERM exit: 


SNA 3270s can invcke an application program LOSTERM exit fcr a 


conditional lcgoff or,a segmenting errcr. 


occur for non-SNA 3270s. 


These conditions do not 


Figure 6-4 shows SNA pfrctoccl differences between LU types 0, 1, 2, and 


3 for the 3270. 
LU Type 0 
Uses full duplex mode 


Uses single-element 
chains 


Never requests responses 
Uses no data flow control 


commands 


Supports COPY command 


Uses limited sense codes 


Does not support Start 


Data Traffic 

Ignores pacing and RU 
sizes in BIND 

Does not use 
unconditional bracket 
termination 

Supports READ command 
to printers 


Uses half-duplex 
flip-flop mode 

Uses multi-element 
chains 

Can request responses 

Sends LUSTAT, SHUTC, 
LU.T1 can send SIGNAL 

Receives CANCEL, 
CHASE, BID, SHUTD, 
SIGNAL 

Uses WRITE with start 
print bit set 

Uses extensive sense 
codes 

Supports Start Data 
Traffic 

Uses pacing and RU 
sizes in BIND 

Uses conditional 
bracket termination 


Does not support READ 
command 


Uses half-duplex 
flip-flop mode 

Uses multi-element 
chains 

Can request responses 
Sends CANCEL, LUSTAT, 
SHUTC, SIGNAL 
Receives CANCEL, 
CHASE, BID, SHUTD, 
SIGNAL 

Uses WRITE with start 
print bit set 

Uses extensive sense 
codes 

Supports Start Data 
Traffic 

Uses pacing and RU 
sizes in BIND | 

Uses conditional 
bracket termination 


Supports READ command 


lpu.tT1 3270s support only unconditional bracket termination; so 


does ACF/VTAM for non-SNA 3270s. 
uses conditional bracket termination; 


For BSC 3270s, VTAM (VS, ACF/VTAM) 
this requires that the VTAM 


application send another end bracket if the request carrying the 
first end bracket indicator fails. 


2For LU.T1 only 


Figure 6-4. 
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LU Type Lifferences 


A sequence number is returned in the 2-byte RPL SEQNO field when a SEND 
is completed. For PU.11 and PU.T2 the whole SEGNO field is used; this 
is also true for OS/VS VTAM support of non-SNA 3270s. However, for 
COS/VS VTAM and OS/VS and DOS/VS ACF/VTAM, cnly the low-order byte of 
the SE QNO field is used; the high-order Eyte is always set to 0. 


Switched Line Support for SNA (Switched 


The IDBLK 12-bit binary numker required 
defined for the 3276 as 018. The IDNUM 
number for the 3276 is factory-assigned 
serial number. (Although the 3274 does 


PU Support) 


cn the switched PU macro is 

20-kit kinary identification 
and is the same as the device 
not support switched PUs, the 


comparable value used as fart of the XID fcr the 3274 is always 0000.) 
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GLOSSARY 


This glossary defines 3270 Information 
Display System terms and other data 
fFrocessing and communicaticn terms used in 
this publication. For definitions of terms 


grateful to the American National Standards 
Institute (ANSI) fcr fermission to reprint 
its definitions frcm the American Naticnal 


an <a eo au awe aoe oe a SIR CE ene aa cme ene ame 


2. en a ae ae a ow oe EP ape a eee RE ORD ee ce —_ aw <. a ow aw a om ae a ow ew oe 


National Standards Institute, Inc.), which 
was prepared Ly Sukcomnittee X3K5 on 
Terminology and Glcssary of American 
National Standards Committee X3. A 
complete commentary taken frcm ANSI is 
identified by an asterisk (*) that appears 
ketween the term and the beginning of the 
commentary; a single definition taken fron 
ANSI is identified by an asterisk after the 
item number for that definition. 


4s 
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between main storage and input/output 
devices. 
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character that is availakle cn any of the 
327G keyboards. 


usually as the result cf an action taken hy 
the operator of the device. 

attention identifier (AIL): A code that is 
set in the display staticn when the 
operator takes an acticn that produces an 
IvyO interruption. The character identifies 
the action or key that generates the 
ccndition. The AIL is set when the display 
station operator presses a frogram access 
key, when a selectcr fen attention occurs, 
cx when a successful oferatcr | 
identification card read-in occurs. The 
AIL also identifies device addresses 
assigned to printers. 


attribute: A characteristic cf a 3270 
display field. The attributes of a display 
field include: protected or unprotected 
(against manual input and ccfy oferaticns) ; 
numeric-only or alphameric input control; 
displayed, nondisplayed, 
display-intensified; 
selector-pen-detectable or -nondetectable; 
and modified or not mcdified. 


—- ane a ae ee ee ee oe ae — -— ae 


attrikutes cf the display field that 
follows. An attrikute character is the 
first character in a display field, but it 
is not a displayable character. 


auditle alarm: A special feature that 
sounds a short, audible tone automatically 
when a character is entered from the 
keyboard inte the next-to-last character 
position cn the screen. The tone can also 


ke sounded under program control. 


automatic (1) A hardware feature 
of a telecommunications unit that processes 
a polling list, polling the terminals in 
order and handling negative responses to 
folling withcut interrupting the central 
processing unit. At the end of the list, 
polling is automatically begun again at the 
keginning cf the list. Syncnymous with 
autopoll. 


into the last character position of an 
unprotected display field, automatic 
repositioning of the cursor from a 
frotected and numeric field to the first 
character position of the next unprotected 
display field. 


len 


Ease Color: Cn color displays, one of four 
colors in which fields can be displayed: 
red, blue, green, or white. 


Ease Color mode: Provides four different 
colors, which can be produced Ly existing 
3270 applicaticn programs with little or no 
reprogramming. 


basic mode (VTAM): A set of facilities 

to use them) that enable the application 
program to communicate with BSC and start- 
stop terminals, including the locally 
attached 3270 Information Display System. 
READ, WRITE, SOLICIT, RESET, DO, and LDO 
macro instructions are basic~mode macro 
instructions. 


Basic Telecommunications Access Method 
(BTAM) : An access method that permits 
read/write communicaticns with remote 


devices. 
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Binary Synchronous Communications (BSC): 
LCata transmission in which character 
synchronism is controlled by timing signals 
generated at the sending and receiving 


stations. 
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can ke used to describe a graphic character 
for a 3270 display or frinter. 
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ketween an application pfrogram and a 
legical unit which accomplishes some task. 
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buffer address: The address cf a locaticn 
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in the buffer at which cne character can be 
stored. 


To) 


aNe aaa GHENO. cxgae ant cna GOED aie i <a ae ame ame ae ane 
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associated with individual characters to 
define character cclor, character set, 
and/or character highlighting. 


GOP ae a ee ane a a eee > <n a cu ae exer 


contains codes for graphic characters or 
field attribute characters. 
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displayed; also, an addressed location in 
the buffer at which cne character can be 
stored. | 


Clear indicator: In VTAM, a SESSIONC 
indicator sent by cne ncde tc another that 
Frevents the exchange cf messages and 
responses. | 


cluster control unit: (1) A device that can 
centrol the control the input/output 
operations of more than one device. A 
remote cluster control unit can he attached 
to a host CPU only via a communications 
controller. A cluster control unit may he 
ccntrolled by a program stored and executed 
in the unit, or it may ke controlled 
entirely by hardware. (2) See also 
communications controller. 
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ccmmand: An instructicn that directs a 
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ccntrol unit or device to perform an 
operation or a set of creraticns. 
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communicaticns contreller: (1) A type of 
communicaticn control unit whose operations 
are controlled ky a f~rogram stored and 
executed in the unit. Examples are the IBM 
3704 and 3705 Communications Controllers. 


request from an application program, the 
linking cf VIAM ccntrol blocks in such a 
way that the program can communicate with a 
particular terminal. The connection 
process includes establishing and freparing 
the network fath between the program and 
the terminal. 


control character: A character used in 
conjuncticn with a Write command to specify 
that a ccentrcel unit is toe perform a 
particular operation. 
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terminal cr a remotely-attached 3270 

terminal that uses the BSC line discipline. 
copy control character (CCC): A character 
used in conjuncticn with the Copy command 
to specify the type of data to be copied. 


the contents cf the Luffer from one display 
station cr printer to another display 
station or printer attached to the same 
control unit. 


Cursor (an underscore) 
that identifies a character position ina 
screen display, usually the character 
position at which the next character to be 
entered from the keykoard will he 
displayed. 


L 


channel in a single read or write operation 
to a display station or printer. 


sending of data from one node to another. 
data transfer mode: (1) A set of facilities 
(including the macro instructions needed to 
use them) that enable the application 

program to communicate with terminals. (2) 
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definite response 1: In VTAM, a response 
that indicates whether its associated 
message was successfully forwarded to its 
final destination (such as the display 
screen of an output device). 


definite respense In VTAM, a response 
that indicates that the node sending the 
response has accepted recovery 
responsibility for the asscciated message. 


definition statement: The means of 


describing an element cf the 
telecommunication system tc VTAM. 
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immediately follows the attrikute character 
in a selector-pen-detectable field. The 
designator character ccntrols whether a 
detect on the field will or will not cause 
an attention. For a nenattention-producing 
field, the designatcr character also : 
determines whether the modified data tag 
for the field is tc ke set cr reset as the 
result of a selectcr-fen detect. 


detectable: An attrikute of a display 
field; determines whether the field can he 
sensed by the selectcr fen. 


disconnection: In VTAM, the disassociation 
cf VTAM control Elccks in such a way as to 
end communication kLetween the program anda 
ccnnected terminal. The disconnection 
process includes suspending the use of the 
network path ketween the prcgram and the 


terminal. 
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characters (in the kuffer) that starts with 
an attribute character (defining the 
characteristics of the field) and contains 
cne or more alphameric characters. The 
field continues to, Lut does not include, 
the next attribute character. 


oe eer eer ee eer 


Cne point in a frinter or display 


dct: 
klock matrix. 


ct 
lo 
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ccmmand that clears all unprctected fields 
to nulls, resets mcdified data tags in all 
unprotected fields, unlocks the keyboard, 
resets the attention identifier, and 
repositions the curscr to the first : 
character of the first unprctected field. 


erase unprotected to address (EUA) order: 
An order that erases all unfrotected 
Ecsitions (inserts nulls) from the current 
kuffer address up to, Eut nct including, 


the specified stop address. 
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fcr storing extended field attributes and 
Character attributes. 


Extended Data Stream 32/0: Enhancements to 
the 3270 Data Stream that allcw color, 
highlighting, and/cr character set 


definition. 


Extended Field Attrikute: An attribute that 
Frovides additional field attribute 
definition keycond that of the 3270 Field 


Attribute. 


FME respcnse: See definite response 1. 


which a display field, or fields, has been 
defined as a result of storing at least one 
attribute character in the display buffer. 
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eneral (1) An input technique for 
remote 3270 devices in which special 
invitaticn characters are sent to a device 
control unit instructing that control unit 
to begin transmission from all devices 
ready to enter data. (2) See also polling 


incomin (1) In systems with TCAM, 

that portion of a message handler designed 
to handle messages arriving for handling by 
the message contrcl pregram. (2) See also 


(IC) order: An order that 


insert cursor 


displays the cursor at the current buffer 
address. 
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display field; causes data in that field to 
ke displayed at a Erighter level than other 
data displayed on the screen. 
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installaticn-defined ccrrelation list that 
translates an argument into a string of 
eight characters. Interpret tables can be 
used to translate a logcn message into the 
name of an application program for which 
the logon request is intended. 
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telecommunications access method (TCAM), a 
sequence cf polling characters or 
identificaticn sequences associated with 
the stations cn line; the order in which 
the characters are specified determines the 
order in which the stations are invited to 
enter a message. 


L 


leased line: See nonswitched line. 
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line control characters: Characters that 
regulate the transpissicn cf data over a 
line; for example, delimiting messages, 
checking for transmissicn errors, and 
indicating whether a station has data to 


send or is ready to receive data. 


line group: In systems with the 
telecommunications access method (TCAM), a 
set of one or more communications lines of 
the same type, over which terminals with 
Similar characteristics can communicate 
with the computer. 


a ae aan ae me 


aizectl; by channels tc a host CPU. 
Contrast with remote. 
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logical unit: The combination of 
Frogramming and hardware of a 
teleprocessing subsystem that comprises a 


terminal for VTAM. 


logoff: In VTAM, a request from a terminal 
to be disconnected frcem an application 
Frogran. 


legcn: In VTAM, a request by or on behalf 
of a terminal to ke ccnnected to an 
application progran. 


iogon message: In VIAM, the data that can 
accompany a logon request received by the 
application program to which the request is 
directed. | 


Bajcr node: A set of cne or more ninor 
nodes represented ty a single symbolic 
name. A major node can ke a.set of local 
terminals, a set of application progn anes 
or a network contrcl [frcegran. 


BCP: See message ccntrcl program. 


BEI: See modified data tag. 

rogran In TCAM, a 
program that is used tc patel the sending 
cr reception of messages to or from remote 
terminals. 


message handler: In systems with the 
telecommunications access method (TCAM), a 
seguence of user-specified macro 
instructions that examine and process 
ccntrol information in message headers, and 
perform functions necessary to prepare 
message segments for fcrwarding to their 
destinations. One message handler is 
reguired for each line grour having unigue 
message handling requirements. 


modified data tag (MIT): A bit in the 
attribute Character of a onehrey field, 
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which, when set, causes that field to be 
transferred to the channel during a 
read-modified operation. The modified data 
tag may be set by a keyboard input to the 
field, a selector-pen detection in the 
field, a card read-in operation, or program 
control. The modified data tag may be 
reset by a selector-pen detection in the 
field, pregram contrcl, or ERASE INPUT key. 
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node: A point in a telecommunication systen 
defined to VIAM ky a symbolic name. See 
also major nede. 

node initialization block (NIB): In VTAM, a 
control tlock, associated with a particular 
node, that ccntains information used by the 
application frogram to identify a node and 
indicate how communication requests 
directed at the node are to be implemented. 


nonswitched line: A connection between a 
remote 3270 unit (3271 or 3275) and a 
computer that does not have to be 


established by dialing. 
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order code: A code that may be included in 
the write data stream transmitted for a 
display staticn or printer; provides 
additional fcermatting or definition of the 
write data. 


order seguence: A sequence in the data 
stream that starts with an order code and 
includes a character address and/or data 
characters related to the order code. 


outgoing group: (1) In systems with TCAM, 
that section of a message handler that 

bhanifulates cutgoing messages after they 
have been removed fron their destination 
queues. 


polling: A technigue Ly which each of the 
terminals sharing a communications line is 
periodically interrogated to determine 
whether it reguires servicing. 


Prepare to Read (PTR): A command for a 
local 3274-1D that allows the terminal to 
know the next program action. 
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attention key that may ke defined to 
solicit program action that does not 
reguire data to be read frcem the buffer of 
the display station. If a kead Modified 
command is issued in response to the 
Frogram attention key interruption, only 
the attention identificaticn (AID) 
Character is transferred to the frogram; no 
data from the buffer is transferred. 
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keybcard that solicits program action Ly 
generating an I/O interrupticn. The keys 
are the CLEAR key, ENTER key, TEST REQ key, 
CNCL key, program functicn keys, and 
Frogram access keys. Fach [rogram 
attention key is associated with a unigue 
attention identificaticn (AILI) character. 


ram-controlled interruyticn (PCT): An 
interruption that allows buffers to be 
deallocated ccntinuously, replenishing the 
available unit pcol. 


program function (EF) key: A program 
attention key that may ke defined to 
sclicit program action that usually 
requires data to be read frcm the buffer of 
the display station. If a Kead Modified 
command is issued in respcnse to the 
Frogram function Key interruption, the 
attention identifier (AIT) and all display 
fields in which the mcdified data tags are 
set are transferred to the frogram. 

Ercgram tab (PT) order: An order that 
advances the current Luffer address to the 
address of the first character location of 
the next unprotected field. 
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Symbols, a maximum of 
Frcogrammed symbol set. 


(ES): Customer-defined 
190 symbols to a 
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the display oferatcr cannot use the 
keykoard or oferator identification card 
reader to enter, mcdify, or erase data. 


R 


record mode: A set of facilities (and the 
macro instructions needed tc use them) that 
enakle the applicaticn [rogram to 
ccmumunicate with logical units or with the 
locally- or remotely-attached 3270 
Information Display System. SEND and 


RECEIVE are record-mode macre instructions. 
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devices to a central ccmputer through a 
ccmmunication control unit. Contrast with 


order: An order that 


stores a specified alphameric or null 
character in up to 480 buffer locations, 
starting at the current buffer address and 
ending at, kEut not including, the specified 
stop address. 


request (RPL): In VTAM, a 
control block that contains the parameters 
necessary for procesSing a request for 
connecticn, communication, or a request for 
an operation related to connection or 
communicaticn. 


lun 


SDLC: Synchrcnous data link control. 


may ke attached to the display station as a 
Special feature. When pointed at a 
detectable portion of an image and then 
activated, the selector pen senses the 
presence of light at a display field and 
produces a selector-pen detect. 


selector pen of the presence of light from 
data ina display field that has the 
detectakle attrikute. Depending on the 
designator character of that display field, 
the detection and location information is 
identified on the screen (and stored in the 
buffer) or may produce an interrupt that is 
transmitted to the CPU. 


that can ke sent from cne node to ancther 
without using SEND or RECEIVE macro 
instructicns. SDT, clear, and STSN are 
SESSIONC indicators. All SESSIONC 
indicators are sent with a SESSIONC macro 
instructicn. 
Set Attribute (SA): An order that 
associates attrikutes in the EAB with 
individual characters. 


order: An order 


set kuffer address (SBA) 
that sets the buffer address to a specified 


location. 


SNA 3270: A 3270 terminal that uses 


synchroncus data link control (SDLC) and is 
treated as a logical unit by VTAM. 


ecific (1) A polling technique 
that sends invitation characters to a 
device to find out whether the device is 
ready to enter data. 


173 


start field (SF) order: An crder that 
indicates a specified lccaticn which 
ccntains an attribute Lyte and not a text 


character. 


Start Field poten: (SFE): An order that 
generates an extended field attribute in 
the EAB and at the current ktuffer locaticn. 


Structured Field: A data stream format that 
permits variable- -length data and controls 
to ke parsed into its ccmfpecnents without 
having to scan every Lyte. 


ress index (SI) order: An order that 
generates the suppress index character, 
valid only for the 3288-2 printer (other 
Frinters receive | an cr kar). This 
character inhibits a line index to allow 
overprinting. 


switched line: A ccmmunicaticn line in 
which the connecticn ketween the computer 
and a remote terminal is established by 
dialing. 
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Jelecommunications Access Method (TCAB) : A 
method used to transfer data between main 
storage and remote or local terminals. 
Application programs use either GET and PUT 
or READ and WRITE macrc instructions to 
reguest the transfer of data, which is 
performed by a message control progran. 
telecommunications network: In a 
telecommunication system, the combination 
of all terminals and cther 
telecommunication devices and the lines 
that connect then. 

terminal: (1) *A point in a system or 
ccmumunication network at which data can 
either enter or leave. (2) Any device 
capable of sending and receiving 
information over a communication channel. 


terminal-intiated logcn: A lcgon. request 
that originates from the terminal. 
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which no attrikute Peace (and, 
therefore, nc display field) has been 
defined. 


unprotected field: A display field for 
which the display station operator can 
manually enter, modify, or erase data. 


laxj 


Virtual Telecommunications Access Method 
(VIAM): A set of IBM programs that control 
communication ketween terminals and 
applicaticn frograms running under DOS/VS, 


CS/VS1, and OS/VS2. 


VIAM: See Virtual Telecommunications Access 
Method. 


or OS/VS data sets chat. contain the VTAM 
definition statements filed during VTAM 
definiticn. These statements describe the 
telecommunication system to VTAM and can be 
used to tailcr VTAM and the system to suit 
the needs of the installation. | 


operation tea cae ie a read operation or 
a cursor movement operation) from the last 
character position in a buffer to the first 
character position in the peteee 

write control character (WCC): A character 
used in conjunction with a Write command to 
specify that a particular operation, or 
combination cf operations, is to he 
performed at a display station or printer. 


command: A 


Write Structured Field (WSF) 
command used for processing structured 


fields. 


3270 data stream: A coded character data 
stream ccnsisting of a command, and, for 
write type ccmmands, a write control . 

character followed Ly crders, attributes, 


and character data. 


INDEX 


access methods 93,137,151 
BTAM 93,136 
BTAM-ES 93 
definition of 169 
TCAM 93,137-151 
VTAM 93,151-167 
VTAME 151 
accounts receivable application 
example of 35 
panels for 8,9,10,35,36,37,38 


address, converting to buffer position 2,75 
AID (see attention identifier) 
alphameric field, definition of 169 
attention, definition of 169 
attention identifier (AID) 
codes for 57 
generally 56 
resetting 68 
attribute byte 
auto-skip, combination for 33 
codes for 50 
default (assumed) values of 45 
definition of 2,169 
example of placement of 3,4,6,7-10 
indicating on panel layout sheet 41 
modified data tag (MDT) in 58 
position occupied by 2,28 
removal of 27,28 
attributes 
assumed values of 44-45 
blink 1,5,6,11 
brightness 29 
character 5,6,8,9,10 
character content 29 
color 5,9-12 
combinations of 31 
definition of 169 
detectable for selector pen 29,30 
displayable 29 
extended field 6-12 
field 2,5,6 
high intensity, changing 82 
modified data tag (MDT) in 30 
nondisplayable 29 
numeric 29 
protected 29 
reverse video 1,5-11 
transmission 30 
type 6-9,50,54,55 
underscore 1,5-11 
value 6-8,10-11,50,54,55 
audible alarm | 
definition of 52,169 
sounding, generally 52 
sounding, with WCC 52,65 
Auto Disconnect feature 123 
automatic copying, description of 73,84-85 


autopoll feature 101-126 
auto-skip 33 


auto-skip field, example of 33,40 


base color 4-5 


Basic Communications Access Method-Extended 
Support. (BTAM-ES) 93-136 


basic mode (VTAM) 162-164,169 

Basic Telecommunication Access Method 
(BTAM), support for 3270 93-136 

binary synchronous communication 
(BSC) 152,155,170 

"blinking," how to avoid 65 

block diagramming 39,40 

brackets, in VTAM 159-160 

brightness, field 30 

"browsing" application 69 

BSC (see binary synchronous communication) 

BTAM (see Basic Telecommunications Access 
Method) 

BTAM-ES (see Basic Telecommunication Access 
Method) 

BTMOD macro instruction 

buffer addresses 

converting 84-85 
definition of 170 

buffer locations, hexadecimal codes 
for 46-47 

buffer positions, converting to screen 
address 75 


124 


calculator, using screen as 37 
CCC (see copy control character) 
character attribute 6,9-12 
character definition 11 


character position, definition of 170 
character sets, loadable and 
nonloadable 12-19 
characters, repeating 81 
CHGNTRY macro instruction, use of 104-105 


clear indicator, in VTAM 
definition of 170 
discussion of 159-160 


CLEAR key, with TCAM 148 
clicks, keyboard 32 
coded Graphic Character Set Local ID 
(CGLI) 11,13 
color 4,5,9-12,19-20 
commands 
definition of 170 
general discussion of 1 
connection, in VTAM 162,164 
control characters 
definition of 170 
general discussion of 1 
COPY command 73,86-92 
copy control character (CCC) 
copy-lock 73 
copying, automatic 
data transfer by 84-85 
device considerations 
generally 84 
PA key, use of 85 
printer-busy considerations 86 
current buffer address 51,66 
cursor 
definition of 170 
indicating, on panel layout sheet 41 
repositioning 64 


83,170 


84-85 


data entry, example of 69-70 


data stream 


coding 42 
concatenation of 87 
decoding 73,75 


definition of 170 
dynamic 84 
elements of 42 
extended 3270 
generating 73 
macro instruction to build 80-82 
mixed read modified input 81 
output, generally 81 
read modified input 74 
relationship of 62 
scanning 74 
sections, generating 82,83 
segments, concatenating 83,84 
selector pen 79 
semi-dynamic 84 
static 81 
subroutine to create 83 
total, generating 82,83 
truncating 76 
variable-length 74 
data-transfer mode 158-164,170 
DECB extension, how to build 99,122 
definition statements, for 3270 152,170 
designator character, selector pen 60,171 
device address, checking DECB for 99 
device control 42 
device status 
errors, recording 98 
maintaining record of 98 
names, assigning 97 
priorities, assigning 98 
transactions, recording 98 
disconnection, in VTAM 162,164,170 
disk files, switching 97 
display buffer image technique 
format of data produced by 75 
1920-character screen check 75 
display field 
characteristics of 
definition of 171 
displaying, intensity of 30 


1,5-6 


27-30 


ENTER key, purpose of 56 
ENTRY operand technique 124 
Erase All Unprotected (EAU) command 
Erase Unprotected to Address (EUA) order 
definition of 171 
generally 66 
multiple fields 66 
positioning 66 
erasing screen data (see also Erase 
Unprotected to Address (EUA) order) 51 
error message, modifying panel to 
include 62 
error recovery 
purpose of 99 
under BTAM 99 
event completion analysis (see Read 
completion analysis and Write 
completion analysis) 
Extended Attribute Buffer 
(EAB) 9,10,15,171 
Extended Highlighting 


199, 114.22, 28 
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68,171 


field concept 27 
field definition, example of 31 
field length 
attempt to key beyond length of 
defining 27,31,32 
fields 
characteristics of 27 
combining using w/password 33 


31,32 


general polling 
definition of 171 
in TCAM 139 


hard copy (see copying, automatic) 
held-line system 103 
hexadecimal, coding orders in 46-49,54,55 
input, selector pen 

detectable 60 

generally 60,80 

keyboard input, combining with 62 
input area, screen 


defining 31,32 
example of 31,32 
input data 


analyzing 56 

eliminating unnecessary 62 
input field, defining 46 
inquiry application 68 
Insert Cursor (IC) order 46,171 
interpret table, in VTAM 154,171 
INTRO macro instruction 145 


Katakana character set codes 92 
keyboard 

data entry 29 

enabling with WCC 65 

resetting 53,65 

restoring 52 

typewriter 29 

unlocking 68 


large screen size 85 
length, field 

defining 2,11,30 

limiting 47 
line activity, table for 98,99 
line control characters 172 
local 3270 

with TCAM 137,141,145 

with VTAM 114 
logoff request, in VTAM 165 
logon request, in VTAM 154,156,164,166 


macro instruction 
default options for 77 
table, building 77 
managing devices, techniques for 92 
mapping 
generally 76 
logic flow for 78 
macro instructions for 
selector pen 81 
table-driven 76,77,80 
master terminal program 
generally 96,97 
uses of 96,97 


77,80 


message 
braodcasting 97 
collecting outstanding 97 
sending as part of a panel 84 
model number, using to calculate buffer 
address 82,83 
modified data tag (MDT) 
definition of 172 
generally 30 
resetting 53,65,68 
selector pen data stream 79 
Modify Field (MF) order 7,43,48 
Monitor macro instruction 125 
MSGFORM macro instruction 146 
multi-colored character 19,20 


non-held line system 103 
non-SNA 3270 
connection 162 
definition of 152,155 ~- 
disconnection 163 
with SNA 3270 164 
null 9 
numeric field 
attempt to enter alphameric data in 32 
defining 32 : 
Numeric Lock feature 29,30 
operating system, switching to another 97 
order sequence 
definition of 171 
using macro instructions to prepare 80 
orders | 
codes for 47 
coding 47-48 
definition of 42, 172 
generally 42 
Insert Cursor (IC) 42 
Modify Field (MF) 7,43 
Program Tab (PT) 70 
Repeat to Address (RA) 
Set Attribute (SA) 8,43 
Set Buffer Address (SBA) 42 
Start Field (SF) 42 
Start Field Extended (SFE) 6,47 


49,51 


paging (see Program Tab (PT) order) 
panel 


Caution against creating with multiple 


Writes 65 
coding in Assembler language 47 
design 34-42 


dynamic 81 
example of sequence of 34-41 
modifying existing 62 
semi-dynamic 81 
static 81,82 
panel designations, assigning 34 
panel layout sheet 
contents of 43-44 
default (assumed) values of 45 
generally 39-40 
use of 39-40 
panel title, how to write 46 
panels, sequence of 39 


planes 
Single 14,19 
triple 14,19-20 


polling 
general 172 
specific 173 
with TCAM 141 
Prepare to Read (PTR) 94 
definition 173 
print authorization matrix 
print key on 3278 91 
printer classes 87-88 
printer modes 87-88 
printers, with TCAM 147-150 
program access (PA) keys 
AID codes for 57 
asSignment of, suggested 
definition of 173 
generally 59 
program attention keys (see CLEAR key, 
ENTER key, program access (PA) keys, and 
program function (PF) keys) 
program function (PF) keys 
AID codes for 57 
assignment of, suggested 59 
definition of 173 
generally 59 
Program Tab (PT) order 
definition of 173 
nulls, use to insert 70 
paging, use for 70 
panel defined with 71 
Programmed Symbols (PS) set 17 
protected field 27 


87-88 


58-59 


Query Reply 20-26 


Read completion analysis 
DOS local 127 
DOS remote Dial 120 


DOS remote leased line 67,100 
OS local 128 

OS remote Dial 121 

OS remote leased line 68,101 


Read Modified input data stream 74 
Read Partition Query 21 
record mode 152,158-161,173 
remote 3270 
with TCAM 137-147 
with VTAM 154 
Repeat to Address (RA) order 
definition of 51, 173 
example of 51 
Reply Mode 24 


SBA codes 58 
screen design 27-72 
SCREEN macro instruction 147 
screen management 
application program, relation to 
functions of 73,74 
generally 73,74 
line control, relation to 74 
screen size, large 85 
selector pen 
accounts receivable example, use 
in 36,37 
definition of 173 
fields detected by 29,30,80 


73-75 


177 


selector pen fields 

attention 60 

format for 59 

macro instruction for 80 

Operator input, combined with 79,80 

selection 59 

table for 80 : 

transmitting 60-62 

which selected 80 
Set Attribute (SA) order 
Set Buffer Address (SBA) order 
Set Reply Mode 12 | 
SNA 3270 

connection 170 

definition of 157 

disconnection 162 

with non-SNA 3270 154 
source device list 88 
split-screen capability 37 
Start Field (SF) order 2,42,47-51,173 
Start Field Extended (SFE) 
order 6,43,47-51,54-55,173 
structured fields 11 
Switched network backup 65 


8,43,173 
2,42,79,173 


TCAM (see Telecommunications Access Method) 
Telecommunications Access Method, support 
for 3270 

handling AID byte 148 

handling remote printers 147 

handling sense/status information 143 

macro instructions 139-149 

message handling 146 

polling with 137 

Read operation 137 
Telecommunications management 

with BTAM 93 

with TCAM 137 

with VITAM 151 
terminal characteristics babie 85 
terminal control program 

advantages of 96 

relationship to other modules 96-97 
terminal-initiated logon, in VTAM 156 
terminals 

adding to a line 97 

definition of 174 

removing from a line 97 
Test Request key, result of 
pressing 102,116 
time of day, maintaining 97 
translate and test (TRI) instructions 
TSF (Write Structured Field Command) 93 
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74,75 


unprotected field, clearing (see Erase 
Unprotected to Address (EUA) order and 
Erase All Unprocecced (EAU) command) 


Virtual Telecommunications Access Method 
connecting with 162 
defining 3270 to 114,157 
disconnecting with 161 
handling. Test Request messages 163 
in basic mode 162-165 
in record mode 158-162 
sense/status information 164 
with non-SNA 3270 164 
with other access methods 
with SNA 3270 164 
VTAM (see Virtual Telecommunications Access 
Method) 
VTAME (see Virtual Telecommunications Access 
Method with : SNA) 


93,137 


WCC (see Write control character) 
wraparound 

generally 33 

undesired result of 64 
Write commands, multiple 

"blinking" caused by 65 

inefficiency of 65 
Write completion analysis 

DOS local 133 

DOS remote Dial 120 

DOS remote leased line 108 

OS local 134 

OS remote Dial 121 

OS remote leased line 109 
Write Continue Conversational Transparent 

(TTVX) 107 | 

Write Continue Transparent (TTX) 107 
Write Continue Transparent Block (TTE) 107 
Write control character (WCC) 

enabling the Keyboard 65 

generally 52 

hexadecimal codes for 53 

in modifying panels 65 

unlock keyboard, use to 70 
Write Structured Field (WSF) 94 
Write Transparent Block (TE) 107 
Write Transparent Text (TX) 107 
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